KohGuanZeh / pe

0 stars 0 forks source link

Help functionality can be more useful #7

Open KohGuanZeh opened 2 months ago

KohGuanZeh commented 2 months ago

Right now, the help command opens a new window that only shows a link where users can copy the URL to the user guide.

Note that this would potentially involve mouse actions to click on the button with the URL.

However, the application already provides a functionality to copy details of user information and the output message box is large enough to display information.

I think the functionality could be better optimized for typists to instead show the user guide link into the command box, telling users to visit the respective user guide site and copying the link to the clipboard instead of opening another window and requiring users to click on a button to copy the URL, given that there already is an existing functionality that does the same thing.

soc-pe-bot commented 2 months ago

Team's Response

Thank you for your suggestion.

Having the new window is a user-friendly way to allow users of all technical abilities to easily access the UG, without needing any prior knowledge of commands such as copy or even help (since we have a Help button at the top of the application).

New users may not know what the help command does, and may expect it to simply show a help menu/window (as is the case in most applications). By following your suggestion, the new user may unintentionally replace the contents of the clipboard, which could possibly contain important information. The important information would be overridden by automatically copying the URL to the clipboard when the user enters help. While windows may have a clipboard history feature to mitigate this, it is disabled by default. Moreover, other OS-es do not have such a feature, making this likely to cause issues to the majority of users.

Also, as mentioned in this forum post, it is not necessary for all features to be accessible via the keyboard, and we feel that having the help link be more easily copied is not as important as other features.

However, we acknowledge that the current implementation of help could be better, and we may consider changing it to output the URL to the message box, but without automatically copying the URL to the clipboard. On the other hand, this also introduces new problems, such as the need to implement another clickable button near the command box, which needs to include additional implementation work.

Items for the Tester to Verify

:question: Issue response

Team chose [response.NotInScope]

Reason for disagreement: [replace this with your explanation]