Check NixOS Manual DocBook rendering against MD rendering #349
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
name: "Check NixOS Manual DocBook rendering against MD rendering" | |
on: | |
schedule: | |
# * is a special character in YAML so you have to quote this string | |
# Check every 24 hours | |
- cron: '0 0 * * *' | |
permissions: | |
contents: read | |
jobs: | |
check-rendering-equivalence: | |
permissions: | |
pull-requests: write # for peter-evans/create-or-update-comment to create or update comment | |
if: github.repository_owner == 'NixOS' | |
runs-on: ubuntu-latest | |
steps: | |
- uses: actions/checkout@v3 | |
- uses: cachix/install-nix-action@v18 | |
with: | |
# explicitly enable sandbox | |
extra_nix_config: sandbox = true | |
- uses: cachix/cachix-action@v11 | |
with: | |
# This cache is for the nixpkgs repo checks and should not be trusted or used elsewhere. | |
name: nixpkgs-ci | |
signingKey: '${{ secrets.CACHIX_SIGNING_KEY }}' | |
- name: Build DocBook and MD manuals | |
run: | | |
export NIX_PATH=nixpkgs=$(pwd) | |
nix-build \ | |
--option restrict-eval true \ | |
-o docbook nixos/release.nix \ | |
-A manual.x86_64-linux | |
nix-build \ | |
--option restrict-eval true \ | |
--arg configuration '{ documentation.nixos.options.allowDocBook = false; }' \ | |
-o md nixos/release.nix \ | |
-A manual.x86_64-linux | |
- name: Compare DocBook and MD manuals | |
id: check | |
run: | | |
export NIX_PATH=nixpkgs=$(pwd) | |
.github/workflows/compare-manuals.sh \ | |
docbook/share/doc/nixos/options.html \ | |
md/share/doc/nixos/options.html | |
# if the manual can't be built we don't want to notify anyone. | |
# while this may temporarily hide rendering failures it will be a lot | |
# less noisy until all nixpkgs pull requests have stopped using | |
# docbook for option docs. | |
- name: Comment on failure | |
uses: peter-evans/create-or-update-comment@v2 | |
if: ${{ failure() && steps.check.conclusion == 'failure' }} | |
with: | |
issue-number: 189318 | |
body: | | |
Markdown and DocBook manuals do not agree. | |
Check https://github.com/NixOS/nixpkgs/actions/runs/${{ github.run_id }} for details. |