doc: add checks on docs integration - #1480
Conversation
The docs integration often depends on overwriting files in the upstream LXD, MicroCeph, and MicroOVN repositories. If those files move or if configuration settings change, it is possible for the build to complete successfully, but with incorrect settings or other issues. This commit separates the `integrate` process in the docs Makefile into several steps: - `integrate-pull` clones the upstream repositories and pins them to specific commits - `integrate-precheck` (depends on `integrate-pull`) confirms that various files are located where expected, and are configured as expected - `integrate` (depends on `integrate-precheck`) copies and overwrites files, and builds the documentation Signed-off-by: Elijah Greenstein <elijah.greenstein@canonical.com>
|
Related to #1475, with regard to the |
|
@roosterfish -- these are some checks intended to catch changes to the upstream repositories before building and serving the integrated documentation. As you can see, I've currently set these up so that the build fails if there are any issues. However, I also considered setting the checks up as make target that could be triggered as a GitHub workflow, such that the build could complete regardless of the status of the checks. Do you have any thoughts on these two approaches? Ultimately I decided on having the build fail. If, for example, the MicroOVN header template is moved to a new directory, it's possible for the build to complete but the built docs to be set up incorrectly. I believe this was the kind of issue that we had with MicroCeph in the MicroCloud 2 docs that was resolved with this PR: #1454. |
The docs integration often depends on overwriting files in the upstream LXD, MicroCeph, and MicroOVN repositories. If those files move or if configuration settings change, it is possible for the build to complete successfully, but with incorrect settings or other issues.
This commit separates the
integrateprocess in the docs Makefile into several steps:integrate-pullclones the upstream repositories and pins them to specific commitsintegrate-precheck(depends onintegrate-pull) confirms that various files are located where expected, and are configured as expectedintegrate(depends onintegrate-precheck) copies and overwrites files, and builds the documentation