Jianwen0451 / pe

0 stars 0 forks source link

[UG Bug] The Quick Start is not user-friendly for target audience #5

Open Jianwen0451 opened 3 days ago

Jianwen0451 commented 3 days ago

Screenshot 2024-11-15 at 5.12.07 PM.png

Your target users are physiotherapists who may not be familiar with command line and terminal commands.

Hence step 4 in Quick Start is not straightforward enough for them to run the app.

It is hard for them to figure out the meaning of "cd in the folder you put the jar file in" if they do not have much experience with computers or terminal operations.

My suggestion is to provide more specific details and may be put a video to help the user to open the app for the first time.

nus-pe-bot commented 7 hours ago

[IMPORTANT!: Please do not edit or reply to this comment using the GitHub UI. You can respond to it using CATcher during the next phase of the PE]

Team's Response

Thank you for your input

However, we do not think that this is a valid bug as the commands that are supposed to be entered into the terminal are formatted in a different way. We feel that for most, if not all, users should not have any problem setting up as they simply have to copy and paste the commands mentioned into their terminal. A video setup guide may be a useful addition and could be provided separately but they should not be added into the User Guide.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: [replace this with your reason]


## :question: Issue severity Team chose [`severity.VeryLow`] Originally [`severity.Medium`] - [ ] I disagree **Reason for disagreement:** [replace this with your reason]