Skip to content

No clear structure for Developer Guide, looks incomplete #2457

Open
@nus-pe-bot

Description

@nus-pe-bot

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.



image.png

Missing table of content - may look minor but it shows a much larger issue of the lack of structure in the developer guide. I am unable to clearly locate the design portion and the implementation portion as they are all mixed up. Hence, the implementation portion looks lacking, only showing some of the features and clearly lacking in showing the implementation of all other features available in the application. There are no diagrams to describe the overall architecture of the app so I am unable to really understand how the components work with one another.

Overall, the developer guide looks incomplete. There seems to be many lacking sections and diagrams. And the diagrams and sections described in it looks to be randomly picked out from all the available components and commands. Hence, it does not give a clear idea of how the app works, thus, the high severity.


[original: nus-cs2113-AY2324S2/pe-interim#2383] [original labels: type.DocumentationBug severity.High]

Metadata

Metadata

Assignees

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions