search

TabrizPlv / pe

0 stars 0 forks source link

Use of technical terms in introduction #16

Open TabrizPlv opened 1 year ago

TabrizPlv commented 1 year ago

image.png

The use of terms like CLI and GUI are overly technical and readers will likely not understand what they mean

nus-pe-script commented 1 year ago

Team's Response

A description of what each acronym means is given right before them.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: A description of what the acronyms stand for is not the same as an explanation of what they are. Even if you inform readers that a CLI is a Command Line Interface, the reader without a technical background will still be confused as to what CLI is. Same goes for GUI.

## :question: Issue severity Team chose [`severity.VeryLow`] Originally [`severity.Low`] - [x] I disagree **Reason for disagreement:** This is not a cosmetic issue nor is it a typo. I believe that a Low severity is fair as it is just the team failing to keep their target audience in mind while writing the UG.