[SKIP CI] .github: add sof-docs build to Github Actions

[marc-hb]

From time to time sof-docs regressions are introduced in sof.git. This
introduces a random and sometimes long delay between when the regression
is introduced and when it is found. A recent example is
#5731 (comment)
where the doxygen comments were duplicated. Doxygen alone did not mind,
then the sof-docs build failed much later which took multiple people a
lot of time to understand and bisect.

Signed-off-by: Marc Herbert marc.herbert@intel.com

[marc-hb]

The build in https://github.com/thesofproject/sof/runs/7220985472 failed as expected because of the doxygen duplication introduced by #5731 (comment). Catching this is exactly the purpose of this new check.

Waiting for @juimonen to remove that doxygen duplication.

Warning: Duplicate target detected: group__sof__dai__drivers_1ga8c720c310f408b2f97ce014562d6a910
/home/runner/work/sof/sof/sof-docs/api/dai-drivers-api.rst:4: WARNING: Duplicate ID: "group__sof__dai__drivers_1ga8c720c310f408b2f97ce014562d6a910".
/home/runner/work/sof/sof/sof-docs/api/dai-drivers-api.rst:4: WARNING: Duplicate explicit target name: "group__sof__dai__drivers_1ga8c720c310f408b2f97ce014562d6a910".
/home/runner/work/sof/sof/sof-docs/api/dai-drivers-api.rst:6: WARNING: Duplicate declaration, const struct device* dai::drv

[intelkevinputnam]

LGTM - Looks like the check is blocking itself. :-)

[deb-intel]

Thanks, Marc!

[lgirdwood]

Good work @marc-hb !

[marc-hb]

Waiting for @juimonen to remove that doxygen duplication.

Just learned @juimonen is on vacation. 2-lines fix/workaround submitted at:

• [SKIP CI] Exclude dai-legacy.h from doxygen to avoid clashes with dai-zephyr.h #5995

This simply excludes dai-legacy.h from doxygen instead of randomly mixing both; good enough for now.