search

vigonometry / pe

0 stars 0 forks source link

[User Guide and Developer Guide] Absence of a glossary/missing terminologies to clarify novel/hard to understand terms #11

Open vigonometry opened 1 year ago

vigonometry commented 1 year ago

Details

As stated. This results in users/developers having to search the internet for what the terms mean and these may not match with the intended definition.

Expected

Developers are expected to produce a glossary of terms that users may be unfamiliar with in the User Guide (e.g. Command Line Interface, Graphical User Interface, command terminal, etc.)

They are also expected to produce a glossary of terms that differ from what a developer is expected to know in the developer guide (the only term mentioned is Mainstream OS, but other terms such as CRUD, in-app reference, etc. should also be added

Screenshots / Screen recordings

Screenshot 2023-04-14 at 3.35.06 PM.png

Screenshot 2023-04-14 at 3.36.47 PM.png

nus-se-bot commented 1 year ago

Team's Response

It does not hinder the user's information given that there were no jargons used, therefore it should not be medium. The suggestion could be implemented in future iterations, which is why it is set to not in scope. Furthermore, there is no specific requirement to clarify novel or hard terms (which our UG does not have.) Therefore, we set it to Low and not in scope.

Items for the Tester to Verify

:question: Issue response

Team chose [response.NotInScope]

Reason for disagreement: [replace this with your explanation]

## :question: Issue severity Team chose [`severity.Low`] Originally [`severity.Medium`] - [ ] I disagree **Reason for disagreement:** [replace this with your explanation]