ThatGirlJam / pe

0 stars 0 forks source link

UG Glossary link under "Purpose" goes to quick start rather than glossary. #17

Open ThatGirlJam opened 6 months ago

ThatGirlJam commented 6 months ago

Glossary link here goes to quick start rather than glossary.

Here is the place with the link:

Screenshot 2024-04-19 at 17.14.11.png

Here is where it links to: Screenshot 2024-04-19 at 17.14.24.png

This is unexpected bahaviour and confusing for the user.

nus-pe-script commented 5 months ago

Team's Response

It actually redirects you to the glossary link in the Overview (TOC), where you need to click Glossary again to go to the actual glossary section.

It is perfectly understandable that you thought it redirects you to the quick start because these 2 lines are very close.

However, we agree that requiring two clicks here is unnecessarily inconvenient, so we accept this issue.

We suggest to classify this as very low severity as this is a low priority issue for v1.4.

Items for the Tester to Verify

:question: Issue severity

Team chose [severity.VeryLow] Originally [severity.Low]

Reason for disagreement: Hello, thank you for your response. Yes, upon your mention it does seem that the glossary link in the Overview links to the outline's "Glossary" bullet point.

Screenshot 2024-04-23 at 16.07.52.png

However, I disagree that the severity should be downgraded severity.VeryLow, and I believe it should remain as a severity.Low issue.

According to the pictures as shown in the original description of the issue, the link is in the context that the user would reasonably assume that the hyperlink would lead to the 'glossary of terminologies'. Furthermore, besides the two clicks being unnecessarily inconvenient as mentioned, there is also the confusion originally faced when I first encountered the issue -- whereby the user may assume the link had lead to the Quick Start section.

As this causes unnecessary inconvenience and confusion for the user, I believe it should remain as a severity.Low issue.

For reference, below is the PE guidelines on broken or incorrect links having a possible severity of Low or Medium.

Screenshot 2024-04-23 at 16.14.58.png