CI script for doxy should generate warnings report
It looks like the CI scripts for documentation are more or less just smoke tests, since there are no tests or artifacts.
The Doxy portion could be more useful if it generated the doxygen.warnings.log
as an artifact.
One could then download and run doc/doxygen.warnings.report.sh
against the warnings log and check for warnings on the files touched by the MR:
$ doc/doxygen.warnings.report.sh -s <downloaded-doxygen.warnings.log> ...
The next step would be to filter the warnings log against the files touched by the MR. For example:
$ doc/doxygen.warnings.report.sh -wf "$(git diff --name-only --diff-filter=d | tr '\n' ' ' | sed 's/ /\\|/g')"