willowisp01 / pe

0 stars 0 forks source link

Inconsistent use of ... notation (for TAG) in the UG #14

Open willowisp01 opened 4 months ago

willowisp01 commented 4 months ago

image.png

For the highlighted part, it ought to be[--tags=TAG]… to show that multiple tags are possible.

soc-pe-bot commented 4 months ago

Team's Response

No details provided by team.

The 'Original' Bug

[The team marked this bug as a duplicate of the following bug]

Command format for add is unclear

Screenshot 2024-04-19 at 4.43.30 PM.png For the add command, the user guide indicates that tag may only be used once, since it does not contain ...

Screenshot 2024-04-19 at 4.44.26 PM.png

However, the add command allows for multiple tags to be included. eg. add --name=Jane Doe --phone=92933578 --email=janed@example.sg --addr=Amy street, block 123, #11-02 --tags=Disabled --tags=SeekingAssistance --note=NA


[original: nus-cs2103-AY2324S2/pe-interim#2849] [original labels: severity.Low type.DocumentationBug]

Their Response to the 'Original' Bug

[This is the team's response to the above 'original' bug]

For the add command, the user guide indicates that tag may only be used once...

Our user guide does not indicate that tag may only be used once. In fact, we have clarified and stated multiple times throughout the UG that there can be any number of tags per client.

The line right after the screenshot used says a client can have any number of tags (including 0).

image.png

Items for the Tester to Verify

:question: Issue duplicate status

Team chose to mark this issue as a duplicate of another issue (as explained in the Team's response above)

Reason for disagreement: [replace this with your explanation]


## :question: Issue response Team chose [`response.Rejected`] - [x] I disagree **Reason for disagreement:** My concern is that the ... notation is missing. In other words, the [TAGS]... notation should mean that the tags can be used 0 or more times. Without ..., it would imply the tags can only be used 0 or 1 times. So it's actually contradicting your Tip as mentioned.