T-Wan-Lin / pe

0 stars 0 forks source link

Glossary Issues #13

Open T-Wan-Lin opened 1 year ago

T-Wan-Lin commented 1 year ago

Screenshot 2023-04-14 at 5.34.46 PM.png

For item 1, that's a bit obvious.

For item 2, you wrote it at the beginning of the DG, making it a bit redundant to redefine it here.

You could have defined terms like Operating Systems etc, if the user isn't tech-inclined and doesn't know what OS means

nus-se-script commented 1 year ago

Team's Response

We clearly used Operating Systems in the DG, and the developer guide is meant for developers who are tech-inclined.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: The team stated that they used the term Operating Systems in DG. Usage != Definition. 'Operating system' is a broad umbrella term and it would be useful for developers to know which OS the application can run on. Even AB3 defines Mainstream OS as Windows, Linux, Unix, OS-X (aka operating systems that can support Java Runtime Environment, JRE)


## :question: Issue severity Team chose [`severity.VeryLow`] Originally [`severity.Medium`] - [x] I disagree **Reason for disagreement:** The absence of a reasonably useful glossary would make maintenance and usage instructions harder to follow as it gets passed around to different developers. ![Screenshot 2023-04-19 at 10.04.55 AM.png](https://raw.githubusercontent.com/T-Wan-Lin/pe/main/files/5045639f-f0a8-4a1a-8e4f-895d6a1a9d6c.png)