Skip to content

[Feature Request] doc: create top-level module checker #8972

@miri64

Description

@miri64

Description

It appears to be every week or so that someone breaks the top-level module view of our nice rendered doc (see #8973 for the most current example). Main culprit most of the time is that they set @ingroup to a group that does not exist.

How about we provide a checker script that checks modules.html directly after the doc was build by the CI, if the list of modules is in line with a given list provided with that checker? If the author of a PR really intends to add a new top-level module (which should rarely happen anyway) they can just append there new module to that list.

Metadata

Metadata

Assignees

Labels

Area: docArea: DocumentationType: enhancementThe issue suggests enhanceable parts / The PR enhances parts of the codebase / documentationType: new featureThe issue requests / The PR implemements a new feature for RIOT

Type

No type

Projects

No projects

Relationships

None yet

Development

No branches or pull requests

Issue actions