search

nus-cs2103-AY2324S2 / pe-dev-response

0 stars 0 forks source link

No explanation in downloading Java 11 #3480

Open nus-pe-bot opened 6 months ago

nus-pe-bot commented 6 months ago

Note from the teaching team: This bug was reported during the Part II (Evaluating Documents) stage of the PE. You may reject this bug if it is not related to the quality of documentation.

Given the target audience is doctors, which may not be as technically savvy as software developers, explanation should be given on how exactly to download Java 11 on the user guide. This is to ensure they download the specifically correct version (right OS, right version etc).

Currently, the user guide only shows this:

image.png

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

joenus commented 6 months ago

Team's Response

Could be improved in future versions. However, we think that including instructions of downloading java would be out of scope as there could be numerous different ways for different systems and operating systems (eg. windows 10, windows 11, mac sonoma (arm), mac sonoma (x86), linux etc) and it's simply not practical.

Duplicate status (if any):

--