ymirmeddeb / pe

0 stars 0 forks source link

not enough code in DG #10

Open ymirmeddeb opened 2 months ago

ymirmeddeb commented 2 months ago

there are many diagrams in the DG, but no code (function examples, class example, code snippets) that help the reader better understand

nus-pe-bot commented 2 months ago

Team's Response

According to the format in AB-3, the developer guide should have an emphasis on using UML diagrams to explain the high level logic of the program. We believe that our UML diagrams are sufficiently detailed to explain the logic. However, we do not believe that copying and pasting huge code blocks would be beneficial for helping developers understand our code better. If developers wish to look at our code, they have our GitHub for that purpose. We believe that the main benefit of the developer guide should not come from looking at code, but by understanding the processes behind the code supported with clear and intuitive explanations.

To counter this issue, we do in fact have some small snippets of code that we use to cite methods and classes as can be seen from the example below:

Screenshot 2024-04-20 190107.png

Items for the Tester to Verify

:question: Issue response

Team chose [response.NotInScope]

Reason for disagreement: [replace this with your explanation]


## :question: Issue severity Team chose [`severity.Low`] Originally [`severity.Medium`] - [ ] I disagree **Reason for disagreement:** [replace this with your explanation]