Insufficient examples in UG

[yiyang74]

No examples for all these commands to let users know whether the output on their device is the intended output. This is especially confusing for the switch_plan command where the user has to enter a follow up input. Update: there are many occurrences like switch_plan with insufficient instructions on the follow up inputs. This is of high severity as user lack information on how to use many parts of the app.

[nus-pe-script]

[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

Thanks for your feedback, but we believe the UI messages and instrctions shown in the programme itself are clear enough for the user to tell if things are going correctly and what to do next. Putting unnecessary examples into UG would reduce readability.

Items for the Tester to Verify

❓ Issue response

Team chose [response.Rejected]

• I disagree

Reason for disagreement: The UI messages and instructions are not clear at all.

In the image below for the rename_plan command, user is shown all his existing plans and instructed to enter a plan name, however, upon entering a plan name within the list, error message is shown that the plan already exists. So, there is no clear instruction on what entering the plan name do.
If the purpose of rename_plan was to only rename the current plan the user is in, why list out all of the user plans and then ask the user to enter a plan name. This creates a misconception that the command lets users choose which plan they want to rename.

Same with the exit command, what does "a Y/y" mean? If user enters "Y/y" exit is cancelled but the instruction say enter "a Y/y" to confirm.

Making the user figure out the what to input is a bug. Moreover, the help command in the app doesn't fill in the information gaps in the UG as well.

Screenshot 2025-04-16 at 8.44.38 PM

---

❓ Issue severity

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

• I disagree

Reason for disagreement: This causes occasional inconvenience to users for reasons as stated above thus, should be of medium severity.

---