What is an ID is not clearly stated

[DrWala]

What the UG says

• The UG mentions "ID" for the first time on page 3 and then on page 6, but does not clearly tell the user what the ID is

Why is this an issue

• Users will not immediately realise that the x/y style phrasing at the end of records (e.g person/session record) is the ID. It would be helpful to state that when a record of any type is created, the ID is appended at the end

Severity justification

Low because it only causes a minor inconvenience and the user will eventually figure it out after playing with the system for a while.

[nus-pe-bot]

Team's Response

The definition of ID is explained in the first command that uses it.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

• [x] I disagree

Reason for disagreement: The first command that uses it in the UG is during the Getting Started section which provides the delete command example. This is not a definition.

If I go to delete person, there is no explanation of ID

The main reason I am disputing this is because the ID system in this project differs from the typical index-based identification AB3 does. There are 2 numbers in every record, and a user will not know which one you are referring to immediately. There is no UI guide that explains that an ID is the thing on the right.

---