Andy's notes on Generalised vertical coordinates

[chrisb13]

Check links was failing on the generated docs_folder/404.html, where root-relative URLs are not resolvable by Lychee in local file mode. This produced false-positive URL-conversion errors and blocked CI despite unrelated documentation links being valid.

• Problem scope

  • Link-check failures were concentrated in generated 404.html entries (/., /season1/, /assets/...) rather than source markdown links.

• Change made

  • Updated documentation/lychee_config.toml to exclude the generated 404 output from path-based scanning.
  • Kept all existing URL-level checks and exclusions intact; only narrowed one noisy generated artifact.

• Config diff (example)

  exclude_path = [
    "site/fontello",
    ".*/404\\.html$",
  ]

[chrisb13]

@AndyHoggANU the idea is that you can put notes (if you wish!) here.

We can then review or merge the PR ahead of tomorrow's meeting. (Another option is just to use the PR-preview until you've finalised.)

[chrisb13]

Here's the PR preview:
https://decoding-access-om3--38.org.readthedocs.build/season2/#generalised-vertical-coordinates

[AndyHoggANU]

I think this is now ready. Happy for edits through a further PR if I've missed anything.

[angus-g]

Thanks, this sets things up nicely!

[chrisb13]

chrisb13 force-pushed the AH-Generalised-Vertical-Coordinates branch from 0fda350 to f1bd4ae

This was to remove the copilot commits:

d730768
faa2d59
0fda350

Looks like I'll resolve this manually.

@AndyHoggANU has expressed he'd like to have this merged, so will merge now.