LINCHENYU2030S / pe

0 stars 0 forks source link

Sort-using term the target user might not know #5

Open LINCHENYU2030S opened 8 months ago

LINCHENYU2030S commented 8 months ago

In the documentation of sort feature, it states that "The sorting is done according to ASCII sequence, but is case-insensitive (i.e. adam has precedence over Beatrice when sorted in ascending order)" Target user may not know the term "ASCII".

Suggetion: The sorting is done according to alphanumerical order, but is case-insensitive (i.e. adam has precedence over Beatrice when sorted in ascending order).

soc-se-bot commented 7 months ago

Team's Response

In the specific sentence quoted, the word "ASCII" contains a hyperlink to another site where the term "ASCII" is explained. However, we hear you and we will certainly include it in the glossary too in a future iteration.

Items for the Tester to Verify

:question: Issue response

Team chose [response.NotInScope]

Reason for disagreement: Screenshot 2023-11-21 at 6.50.44 PM.png

I still think that instead of providing a hyperlink for a user to understand how ASCII sequences work, and how comparators involving ASCII sequences work, it is better to just state "The sorting is done according to alphanumerical order, but is case-insensitive", this will be much more straightforward for a user to understand, especially a non-tech background user. So I still consider it as an improvement under explanation -> using terms the reader might not know.