SoulUseless / pe

0 stars 0 forks source link

Usage of technical terms #4

Open SoulUseless opened 3 years ago

SoulUseless commented 3 years ago

Error message provided for an invalid command format might be slightly technical, given that the user profile indicated in the DG does not imply one with sufficient computing background to grasp the concept of an "unsigned integer" (DG only mentioned that the users are more comfortable with CLI over GUi - this may not necessarily mean that the user understands unsigned integer. For better clarity, it might be better to indicate that only positive integers are allowed.

image.png

nus-pe-bot commented 3 years ago

Team's Response

Our target audience is SOC students, and it would be expected of them to know the term. Even though a user might not understand, google will explain it as well.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: I would posit that the term unsigned is a relatively specific term that could even be language-specific. I would argue that even some SOC students might not know what the term "unsigned" means considering that this term was never really formally introduced to us unless the module dictated.

Telling the user to google whatever term that is used would further reinforce my point that the term might be too technical. Furthermore, asking the user to google a term would also add an additional step to the user interaction, thereby hindering usage. There are a few simple alternatives that the group could have easily went for that would not make this an issue (E.g. "User input is not more than 0", or a simple "User input is invalid").

This tells me that the error messages have not been sufficiently thought through from the user's perspective, thereby warranting an issue.