You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Please describe the problem
Hey guys! What I personally noticed that was your User Guide started immediately from the QuickStart with an image of pre-input data and some instructions about help Command, list etc.
It then continues on to the Features portion about each Command and its format and interface, before then arriving at Security, which is your login register etc.
What the problem here is, that new Users following your QuickStart guide would actually be greeted by your login page, and hence when I was reading through your UserGuide and following said instructions I was stuck I was led to believe I could immediately type help or list and tried those before failing. It was only after I tried to scroll through the user guide, past features then to security did I realise I had to register or login.
Describe the improvement you'd like to suggest
What I would suggest would be either to edit your QuickStart guide to really be from a perspective of a new User, therefore, instructing them to register and logging in before telling them about the available commands such as help, list etc. Also, your features portion in the UG would then nicely come after.
Either that or you guys could also put Security at the top, so that Users would find it easier to solve the logging in issues immediately without having to scroll that much further down!
Additional context
Just a suggestion, and it's not anything pertinent to the execution of your application. Just something that would make your User Guide, QuickStart guide and App more User/Beginner friendly.
Please describe the problem
Hey guys! What I personally noticed that was your User Guide started immediately from the QuickStart with an image of pre-input data and some instructions about help Command, list etc.
It then continues on to the Features portion about each Command and its format and interface, before then arriving at Security, which is your login register etc.
What the problem here is, that new Users following your QuickStart guide would actually be greeted by your login page, and hence when I was reading through your UserGuide and following said instructions I was stuck I was led to believe I could immediately type help or list and tried those before failing. It was only after I tried to scroll through the user guide, past features then to security did I realise I had to register or login.
Describe the improvement you'd like to suggest
What I would suggest would be either to edit your QuickStart guide to really be from a perspective of a new User, therefore, instructing them to register and logging in before telling them about the available commands such as help, list etc. Also, your features portion in the UG would then nicely come after.
Either that or you guys could also put Security at the top, so that Users would find it easier to solve the logging in issues immediately without having to scroll that much further down!
Additional context
Just a suggestion, and it's not anything pertinent to the execution of your application. Just something that would make your User Guide, QuickStart guide and App more User/Beginner friendly.
Reported by: @lucdx
Severity:
Low
[original: nusCS2113-AY1819S1/pe-1#398]
The text was updated successfully, but these errors were encountered: