YoengKokLeong / pe

0 stars 0 forks source link

Instructions presented how to understand for readers #12

Open YoengKokLeong opened 2 months ago

YoengKokLeong commented 2 months ago

Screenshot 2024-04-19 at 5.36.04 PM.png

the explanation is messy for features with multiple forms of command variation.

Information on what the a/ b/ mean is bundled together with information on how to use it and what it filters out and leads to slight confusion at first and requires a second read to understand the intention.

soc-pe-bot commented 2 months ago

Team's Response

Thank you for raising this as a potential issue.

While we do acknowledge that it might be slightly confusing, we felt that the multiple variations of this command has been explained clearly as seen from the list. Perhaps a reordering/reformatting of the point list could have been done to present information in a clearer way for more users.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: If the issue has been acknowledged to be potentially true to any sort of extent, large or small, and an improvement idea has been given back to reorder or reformat the point list, to reject this response would then be quite illogical in a sense.

Furthermore, although the dev team still believes that the commands have been explained clearly as seen from the list, in my opinion it is difficult for a creator himself who is well versed in their own work, to assume the level of readability and understandability of their own work while rejecting a tester's initial 'raw' firsthand experience with the program and UG.


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