Open gerteck opened 4 months ago
No details provided by team.
[The team marked this bug as a duplicate of the following bug]
Insufficient manual testing guidance in DG
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.
The instructions for manual testing is insufficient, only have delete command. It would be good to include more commands.
[original: nus-cs2103-AY2324S2/pe-interim#4214] [original labels: severity.Low type.DocumentationBug]
[This is the team's response to the above 'original' bug]
Thank you for reporting. However, we have to choose it as NotInScope because this issue doesn't affect the current usage of the product and is not actually a flaw. The most important section for manual testing is the Launch and Shutdown as these are the two necessary steps for the testing to be carried out. Other than them, other instructions are not necessary. Specifically, we have explained very clearly how each feature works in previous sections of DG. "Deleting a person" is provided just as an example to inspire the users on how to test the product. Including too many details for testing would make the DG unnecessarily long, which hinders the user's reading experience. The reality is, some people might prefer concise and simple DG just instructing about the implementation of the system and significant features, while others might prefer very detailed explanations for every aspect of the product, such as the testing steps. It is very hard to satisfy all reader's tastes. We might want to consider adding more testing examples in future iterations, but providing the work we have already done, the proposed issue is not in the scope.
Items for the Tester to Verify
:question: Issue duplicate status
Team chose to mark this issue as a duplicate of another issue (as explained in the Team's response above)
Reason for disagreement: [replace this with your explanation]
There should be more information on how to test various commands not just shutdown, delete commands.
Application has total of 21 commands, but no instructions are given besides basic
exit
anddelete
command.Providing accurate and more steps to test would benefit users who have never used the app.