Link checker across nix documentation properties

Observations

If we add more links, they might break. We can automate finding broken links between our things, in principle, and run it in ci. One difficulty is that the repos aren't versioned together but this could be overcome.

Cargo's book has a link checker iirc, could maybe use that.

Problem

With more links come more possibilities to break them. We could catch the breakage automatically.

Approaches

Write script that reads html files of built sites, soups the links out, and validates the target files exist with the appropriate anchors. Run in CI here or elsewhere.

Willing to help?

Sure

Priorities

Add 👍 to issues you find important.

Start by reviewing how the built documentation sites are produced and where CI workflows are defined. Compare the proposed approach with Cargo's book link checker, then determine how to read built HTML, validate target files and anchors across separately versioned repositories, and run the check in CI. Done means broken links are detected automatically.