2022-09-11 15:47:08 +00:00
|
|
|
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:
|
2022-09-14 18:05:37 +00:00
|
|
|
pull-requests: write # for peter-evans/create-or-update-comment to create or update comment
|
2022-09-11 15:47:08 +00:00
|
|
|
if: github.repository_owner == 'NixOS'
|
|
|
|
|
runs-on: ubuntu-latest
|
|
|
|
|
steps:
|
|
|
|
|
- uses: actions/checkout@v3
|
|
|
|
|
- uses: cachix/install-nix-action@v17
|
|
|
|
|
with:
|
|
|
|
|
# explicitly enable sandbox
|
|
|
|
|
extra_nix_config: sandbox = true
|
|
|
|
|
- uses: cachix/cachix-action@v10
|
|
|
|
|
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.
|
