jwdavis0200 / pe

0 stars 0 forks source link

Images used in the UG for features examples is redundant/ineffective for value adding. #10

Open jwdavis0200 opened 1 year ago

jwdavis0200 commented 1 year ago

The Features in the UG were explained with many examples and result-of-command lists but fails to show the difference between the before-command state of the list and the after-command state of the list, hence is not useful to the user to learn about how the commands change the state of the HealthContact lists.

May even add to the clutter of the UG rather than guide users, since they can't tell the difference anyways.

image.png

Above Figure: User viewing the image can't tell the difference between before-command and after-command since only after-command is shown.

nus-pe-script commented 1 year ago

Team's Response

Technically the result of the command is shown, which is more important thean showing before execution of the command.

Items for the Tester to Verify

:question: Issue severity

Team chose [severity.VeryLow] Originally [severity.Low]

Reason for disagreement: This is not a cosmetic issue, which is the definition of severity.verylow. This causes minor inconvenience to new users as they first try to use the edit feature of the application.

The result of the command is shown and of course, the result I agree is important to show. But then as a user jus starting to use the app, how would I know what changed from the initial state?

Then to answer that question, I would be forced to try the edit command itself on the app(say with the given example commands in the UG perhaps with a patient in the app to see the state change in the app's lists /patient fields).

However, I do agree with the team that the result of the command is useful to the user.