insafhere / pe

0 stars 0 forks source link

Unclear user story for help command #14

Open insafhere opened 1 year ago

insafhere commented 1 year ago

image.png

Perhaps could phrase this in this manner to address the help command:

As a "student", I want to "be able to view the existing command summary with a simple help command" so that i can "know how to use the application"

soc-se-bot commented 1 year ago

Team's Response

"view the existing command summary" overly narrows down the role of the help command.

The 'Original' Bug

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

User Story is unclear

Note from the teaching team: This bug was reported during the Part II (Evaluating Documents) stage of the PE. You may reject this bug if it is not related to the quality of documentation.


From DG:

image.png

Perhaps the first User story is trying to address the search feature, hence it could have been written in this way to avoid confusion:

As a "student" i want to "search for modules by module code, name or faculty" so that i am able "to know the existing/available modules i can take during my semester"


[original: nus-cs2113-AY2223S1/pe-interim#25] [original labels: type.DocumentationBug severity.Medium]

Their Response to the 'Original' Bug

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

Changing the user story's phrasing wont change how we designed the product

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: This is a separate issue addressing the command summary. It is not the same user story as the duplicate issue tagged.


:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: As a reader i do not understand what it means to "get help". Hence i believe it should be written as :

As a "student", I want to "be able to view the existing command summary with a simple help command" so that i can "know how to use the application"


:question: Issue severity

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

Reason for disagreement: [replace this with your explanation]