kokerinks / pe

0 stars 0 forks source link

`find` command: Unfriendly help message #7

Open kokerinks opened 4 months ago

kokerinks commented 4 months ago

To recreate: Run the command find asd (assume no names include asd) this will cause the application to show 0 contacts.

image.png

If the user does not know to run the list command to reshow everyone, the user will be stuck here not knowing what to do. They may then have to run through the whole user guide (which is 22 pages long) to figure out what to do.

The help message can be updated to include something like:

To see your full list of members again, run `list`.
nus-pe-bot commented 4 months ago

Team's Response

Thanks for your feedback, but we don't think this is a grave issue. Assuming the user followed the UG to try entering the commands, the list command appears at the top, right before the find command. Moreover, the command to see the full list of contacts is trivial.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: I think it is more obvious to us (as developers who have worked on AB3 for 1-2 months) that we should use list to get back the full list. However, it may not be as obvious to new users who have not seen the application before.

Assuming the user followed the UG to try entering the commands, the list command appears at the top, right before the find command.

As for this, we likely do not expect the user to go through the whole list of commands from top to bottom (pg7 - pg19). It is meant more as a "reference" for the user.

Moreover, the command to see the full list of contacts is trivial.

While the list command is trivial, the point still stands. If the user does not even know that the list command should be used in this situation, then it does not matter how simple the command is.