docs(links): five See Also links had no text at all

A generated See Also pass left `- ](index.md)` style links on the gitea pages, tools/cachyos.md,
and tools/applications.md. Rendered, an empty-text link is a bullet with nothing clickable in it,
so it reads as a formatting quirk and never as the broken reference it is. All five now name the
page they point at and use the absolute bundle path the spec recommends; the grep that finds them
is recorded in the log so the sweep is repeatable.

Refs #64
This commit is contained in:
Frank committed 2026-10-21 02:43:15 -07:00
1 parent 64bb23b329
commit de7dd6f897
6 files changed
+10 -5

No files matched your search

+5
View File
@@ -112,6 +112,11 @@ seventeen minutes. `task.maxConcurrency` is 2, so five were queued while two thr
`proc://` labels a queued task `running` — which is not the claim it sounds like. Cancelling five `proc://` labels a queued task `running` — which is not the claim it sounds like. Cancelling five
let the survivors land within minutes. let the survivors land within minutes.
One mechanical find worth keeping: a generated See Also block had left **five links with empty
text** (`- ](index.md)`) across the gitea pages, `tools/cachyos.md`, and `tools/applications.md` —
rendered, that is a bullet with nothing in it to click, so it reads as a style choice rather than a
broken reference. `grep -rnE '(^|[ ,])\]\('` finds them in one pass.
The day's three `## 2026-10-21` sections are now one section with four subsections, which is what The day's three `## 2026-10-21` sections are now one section with four subsections, which is what
the spec's one-dated-section-per-day rule always meant; [references/okf-maintenance.md](references/okf-maintenance.md) the spec's one-dated-section-per-day rule always meant; [references/okf-maintenance.md](references/okf-maintenance.md)
says so explicitly now. says so explicitly now.
+1 -1
View File
@@ -73,4 +73,4 @@ graph LR
- [cachyos](/tools/cachyos.md) — Operating system documentation - [cachyos](/tools/cachyos.md) — Operating system documentation
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell - [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell
- [niri](niri/index.md) — Compositor - [niri](niri/index.md) — Compositor
- ](ghostty/index.md) — Terminal configuration - [Ghostty](/tools/ghostty/index.md) — terminal configuration
+1 -1
View File
@@ -106,7 +106,7 @@ CachyOS with Niri ships with a curated set of applications:
## See Also ## See Also
- ](../system/index.md) — system overview - [System hosts](/system/index.md) — the fleet's machines and roles
- [niri](niri/index.md) — Compositor documentation - [niri](niri/index.md) — Compositor documentation
- [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell documentation - [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell documentation
- [applications](/tools/applications.md) — Application reference - [applications](/tools/applications.md) — Application reference
+1 -1
View File
@@ -82,6 +82,6 @@ Note: the full-stack repo compose (`dankclaw/compose.yaml`) maps Gitea HTTP to h
## See Also ## See Also
- ](index.md) — index with management commands - [Gitea on dankclaw](/tools/gitea/index.md) — what lives where
- [management](/tools/gitea/management.md) — operations, boot persistence, incident - [management](/tools/gitea/management.md) — operations, boot persistence, incident
- [data-persistence](/tools/gitea/data-persistence.md) — volumes and backups - [data-persistence](/tools/gitea/data-persistence.md) — volumes and backups
+1 -1
View File
@@ -63,6 +63,6 @@ Set `PGPASSWORD` from `/home/dank/Containers/gitea/env` (mode 0600, `GITEA_DB_PA
## See Also ## See Also
- ](index.md) — index with management commands - [Gitea on dankclaw](/tools/gitea/index.md) — what lives where
- [management](/tools/gitea/management.md) — operations and boot persistence - [management](/tools/gitea/management.md) — operations and boot persistence
- [architecture](/tools/gitea/architecture.md) — network and ports - [architecture](/tools/gitea/architecture.md) — network and ports
+1 -1
View File
@@ -99,7 +99,7 @@ Verify the fix on the next host reboot.
## See Also ## See Also
- ](index.md) — index - [Gitea on dankclaw](/tools/gitea/index.md) — what lives where
- [client-access](/tools/gitea/client-access.md) — how client hosts authenticate (token + credential store) - [client-access](/tools/gitea/client-access.md) — how client hosts authenticate (token + credential store)
- [architecture](/tools/gitea/architecture.md) — network topology - [architecture](/tools/gitea/architecture.md) — network topology
- [data-persistence](/tools/gitea/data-persistence.md) — backups - [data-persistence](/tools/gitea/data-persistence.md) — backups