search

FYL2003 / pe

0 stars 0 forks source link

Order of introducing the commands #2

Open FYL2003 opened 4 days ago

FYL2003 commented 4 days ago

list command may be introduced after archive user is not knowing what is archive yet

nus-pe-bot commented 1 day ago

Team's Response

Although we get that certain ordering of the commands in the UG could potentially make some command scenarios more convenient for the user to follow, as it does not affect the usage of the app or its functionalities at all, and some of our other commands do also make some references to other commands, it would be difficult to order all the commands appropriately one after the other without affecting the flow of a few commands.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: Before introduction for list command, the concept of archive is not introduced to the user; hence, when the user encounters this terminology, they might be confused and have to move back and forth in the document in order to know what an archive is. And I think this falls into the case of: Appears only in very rare situations and causes a minor inconvenience only. category for UG (documentation), hence DocumentationBug: Severity.Low is assigned. Screenshot 2024-11-19 at 12.46.02 PM.png As the figure stated, the whole list command showcase is built on some understanding of archive feature.

Footnote: list person command is introduced in page 6 in UG and archive related commands are introduced in page 14, 15 in UG