lihaoquan / pe

0 stars 0 forks source link

DG insufficient instructions for Launch and Shutdown section #11

Open lihaoquan opened 3 months ago

lihaoquan commented 3 months ago

On page 38 of the DG, the following instructions are displayed for Initial Launch

image.png

However, before step 5 (underlined in red), there should be an additional instruction to check the user's Java version, as demonstrated in the PE instructions page:

image.png

While this may be nitpicking, adding an additional line (to ask users to check their Java version) may save the user from having to troubleshoot the launching of the application should they miss earlier, separate instructions that specifies that Java 11 must be used for this application.

soc-pe-bot commented 3 months ago

Team's Response

In our prerequisites for all features (at the top of the appendix), we have stated that Java 11 or above is installed, unless specified otherwise as a prerequite.

image.png

Therefore, the step to check the Java version is not required, as it is not strictly wrong to omit it, since the prerequisites should have already been fulfilled before the users perform the initial launch steps.

Asking the user to check their Java version before launching the application, is optional in our opinion, as we stated that These instructions only provide a starting point for testers to work on; testers are expected to do more explorartory testing, suggesting that the reader should know that they should check if Java 11 or above is installed before testing the steps.

Therefore, this issue is rejected.

Items for the Tester to Verify

:question: Issue response

Team chose [response.Rejected]

Reason for disagreement: [replace this with your explanation]