leongdl135 / pe

0 stars 0 forks source link

UG: Poor use of Diagrams #13

Open leongdl135 opened 1 year ago

leongdl135 commented 1 year ago

The diagrams provided are insufficient to illustrate certain commands. Furthermore, the lack of labelling makes it hard for me to see the difference.

nus-se-script commented 1 year ago

Team's Response

We are unsure which diagrams the tester is referring to. Furthermore, all diagrams come with a brief description so readers can understand them easily.

Items for the Tester to Verify

:question: Issue response

Team chose [response.IssueUnclear]

Reason for disagreement: I disagree since I am using the term the diagrams which implies all the diagrams used in the User guide. While the diagrams come with a brief description, they are not annotated with what has been changed after each command has been given.

For example, in the sort command,

image.png

As there is no annotation of what has changed and the images look similar, I am unsure as to what has happened.

Additionally, for other important commands such as edit, there are no images attached to show what has happened when a command is given. Thus, I believe that this is a bug with the User Guide.