Several relative links in docs/reference.md are written as if resolved from the repository root, but Markdown resolves relative links against the file's own directory, so they currently 404:
- line 48:
[docs/demos.md](docs/demos.md#payment-demo-gate) resolves to docs/docs/demos.md
- line 199:
[docs/api-surface.md](docs/api-surface.md) resolves to docs/docs/api-surface.md
- line 232: link to
docs/governed-data-plane.md — same double-docs/ pattern
- line 310: link to
docs/issue-to-pr.md — same double-docs/ pattern
- line 76:
[CONTRIBUTING.md](CONTRIBUTING.md) resolves to docs/CONTRIBUTING.md, but the file lives at the repository root, so this needs ../CONTRIBUTING.md
The same class of bug appears in docs/rust-kernel-architecture.md line 774, where [docs/trusted-kernel-package-truth.md](../../docs/trusted-kernel-package-truth.md) resolves outside the repository entirely; the target exists at docs/trusted-kernel-package-truth.md, so a ./ prefix would fix it.
All verified by resolving each link relative to its containing file against a fresh clone. Happy to send a PR correcting the paths if that is preferred.
Several relative links in
docs/reference.mdare written as if resolved from the repository root, but Markdown resolves relative links against the file's own directory, so they currently 404:[docs/demos.md](docs/demos.md#payment-demo-gate)resolves todocs/docs/demos.md[docs/api-surface.md](docs/api-surface.md)resolves todocs/docs/api-surface.mddocs/governed-data-plane.md— same double-docs/patterndocs/issue-to-pr.md— same double-docs/pattern[CONTRIBUTING.md](CONTRIBUTING.md)resolves todocs/CONTRIBUTING.md, but the file lives at the repository root, so this needs../CONTRIBUTING.mdThe same class of bug appears in
docs/rust-kernel-architecture.mdline 774, where[docs/trusted-kernel-package-truth.md](../../docs/trusted-kernel-package-truth.md)resolves outside the repository entirely; the target exists atdocs/trusted-kernel-package-truth.md, so a./prefix would fix it.All verified by resolving each link relative to its containing file against a fresh clone. Happy to send a PR correcting the paths if that is preferred.