jrchoo / pe

0 stars 0 forks source link

Advanced filtering section #13

Open jrchoo opened 8 months ago

jrchoo commented 8 months ago

It may be very difficult for NUS students (especially non-SOC students) to use the advanced filtering if they do not have prior knowledge of logical operators and boolean expressions. I would reduce the amount of jargon and perhaps include more images as opposed to text to give the user a better understanding.

image.png

image.png

nus-se-script commented 8 months ago

Team's Response

Thanks for the feedback and suggestion! We appreciate your concern for the accessibility of this feature to all users, including those from NUS who may not be from the School of Computing.

We think this is a suggestion that makes sense, and we will look to include it in future iterations. We will label this as NotInScope.

The user guide has been designed to cater to a diverse user base, including both technical and non-technical users. We explicitly include a "basic filtering" section which is designed for the general user without such technical knowledge, ensuring that all users have a point of entry that matches their skill level. We deprioritised simplifying the advanced filtering section for v1.4 because we think that the basic filtering section is sufficient "fallback" for v1.4, since the "advanced filtering" section is meant to be an optional add-on that should be used and read in the rare situation that basic filtering doesn't work for them.

Additionally, we included many examples in the "advanced filtering" section which together fully explain what every single boolean operator supported means and how they can be used for a technical audience. We don't think that that much jargon can be removed since the only "unapproachable" words are the names of the logical operators used which can't be replaced. Therefore, due to the rarity of the advanced filtering section, and the fact that we think its simplification is near completion, we will mark this as a flaw that is unlikely to affect normal operations of the product and appears only in very rare situations and causes a minor inconvenience only.

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]