avielcx / pe

0 stars 0 forks source link

Unclear instruction #5

Open avielcx opened 1 year ago

avielcx commented 1 year ago

image.png

Instruction says tags are separated by spaces, but then "difficult later 3.14" is considered a single tag ,

nus-se-script commented 1 year ago

Team's Response

Like the examples given for the other attributes, the example of difficult later 3.14 was to demonstrate a valid list of tags that can be passed as an argument and does not show that it was recorded as a single tag.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: This bug report is a documentation bug precisely because of poor language use, and thereby, users cannot understand the developers' intentions. While experienced programmers can still try to navigate through the tag feature, it can be overwhelming for non-programming users, which can be many of your target users. A label of low severity is already an understatement, given that the complexity of the program and the poor language use can induce users to refrain from using the program at all.

The rebuttal to this documentation bug which is also unclear, is a further affirmation of this bug, given that the developers find the need to further their sentence meant.

As such, this documentation bug to be considered a low severity is already underplaying its severity. It would be great if there is the possibility to increase the severity to medium.