spencernah / pe

0 stars 0 forks source link

In UG, editing contacts feature did not mention about selecting an index greater than list size #18

Open spencernah opened 2 years ago

spencernah commented 2 years ago

Document did not mention that users are not allowed to select an index (SEQ_NO_OF_CONTACT) that is within the list size

soc-se-bot commented 2 years ago

Team's Response

There is already an error message prompting users to enter the correct index. Mentioning it in the documentation seems unnecessary since it is likely a typo.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: Even though error message is present, the purpose of a UG is to educate users on what the function offers and the limitations/constraints of a function, if any. In other words, the users should know what they can and cannot perform with the function.

Aside from the purpose of UG and from an academic point of view, we can see that this is implemented in AB3 UG even though it is phrased slightly differently. Thus, this is a requirement or baseline of a UG. Please refer to the below screenshot for reference. Screenshots are obtained from AB3 UG (https://se-education.org/addressbook-level3/UserGuide.html)

image.png

image.png


:question: Issue severity

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

Reason for disagreement: [replace this with your explanation]