search

nus-cs2103-AY2425S1 / pe-dev-response

0 stars 0 forks source link

Target audience might not understand quick start instructions in UG #3459

Open nus-pe-bot opened 2 weeks ago

nus-pe-bot commented 2 weeks ago

image.png

I'm fairly certain that not all students in university would know how to navigate to a folder via the terminal. It would probably help to simplify this section to cater specifically to non-Computing students, or at least those who have never used or are inexperienced with the terminal.

[original: nus-cs2103-AY2425S1/pe-interim#2621] [original labels: severity.Low type.DocumentationBug]

SeeYangZhi commented 2 weeks ago

Team's Response

Thank you for your feedback!

We understand the tester’s concern regarding using terms like cd and the CLI-based instructions. However, we believe this issue is invalid.

Similar to our response in the PE-D issue (#399), the target audience for SpleetWaise includes university students who are expected to have a basic understanding of how to navigate and execute commands in a Command Line Interface (CLI). Using the cd command is a fundamental skill and reasonably expected knowledge for users comfortable with CLI-based applications.

Furthermore, including detailed instructions on how to navigate folders or use cd would dilute the focus of the User Guide and overly cater to an audience outside of the intended scope ("those who have never used or are inexperienced with the terminal" as mentioned by the tester).

Best regards, The SpleetWaise Team

Duplicate status (if any):

--