From de7dd6f8970238215a9db672f69f53478347b934 Mon Sep 17 00:00:00 2001 From: Frank Date: Wed, 21 Oct 2026 02:43:15 -0700 Subject: [PATCH] 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 --- omp-docs/log.md | 5 +++++ omp-docs/tools/applications.md | 2 +- omp-docs/tools/cachyos.md | 2 +- omp-docs/tools/gitea/architecture.md | 2 +- omp-docs/tools/gitea/data-persistence.md | 2 +- omp-docs/tools/gitea/management.md | 2 +- 6 files changed, 10 insertions(+), 5 deletions(-) diff --git a/omp-docs/log.md b/omp-docs/log.md index 14e561c..fee0472 100644 --- a/omp-docs/log.md +++ b/omp-docs/log.md @@ -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 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 spec's one-dated-section-per-day rule always meant; [references/okf-maintenance.md](references/okf-maintenance.md) says so explicitly now. diff --git a/omp-docs/tools/applications.md b/omp-docs/tools/applications.md index 0b5eaef..9d3285b 100644 --- a/omp-docs/tools/applications.md +++ b/omp-docs/tools/applications.md @@ -73,4 +73,4 @@ graph LR - [cachyos](/tools/cachyos.md) — Operating system documentation - [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell - [niri](niri/index.md) — Compositor -- ](ghostty/index.md) — Terminal configuration +- [Ghostty](/tools/ghostty/index.md) — terminal configuration diff --git a/omp-docs/tools/cachyos.md b/omp-docs/tools/cachyos.md index 1b28ae8..fc973ff 100644 --- a/omp-docs/tools/cachyos.md +++ b/omp-docs/tools/cachyos.md @@ -106,7 +106,7 @@ CachyOS with Niri ships with a curated set of applications: ## See Also -- ](../system/index.md) — system overview +- [System hosts](/system/index.md) — the fleet's machines and roles - [niri](niri/index.md) — Compositor documentation - [noctalia-shell](/tools/noctalia-shell.md) — Desktop shell documentation - [applications](/tools/applications.md) — Application reference diff --git a/omp-docs/tools/gitea/architecture.md b/omp-docs/tools/gitea/architecture.md index 0304f94..3876762 100644 --- a/omp-docs/tools/gitea/architecture.md +++ b/omp-docs/tools/gitea/architecture.md @@ -82,6 +82,6 @@ Note: the full-stack repo compose (`dankclaw/compose.yaml`) maps Gitea HTTP to h ## 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 - [data-persistence](/tools/gitea/data-persistence.md) — volumes and backups diff --git a/omp-docs/tools/gitea/data-persistence.md b/omp-docs/tools/gitea/data-persistence.md index 5a9e078..3e3847c 100644 --- a/omp-docs/tools/gitea/data-persistence.md +++ b/omp-docs/tools/gitea/data-persistence.md @@ -63,6 +63,6 @@ Set `PGPASSWORD` from `/home/dank/Containers/gitea/env` (mode 0600, `GITEA_DB_PA ## 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 - [architecture](/tools/gitea/architecture.md) — network and ports diff --git a/omp-docs/tools/gitea/management.md b/omp-docs/tools/gitea/management.md index ed191ea..4a8956f 100644 --- a/omp-docs/tools/gitea/management.md +++ b/omp-docs/tools/gitea/management.md @@ -99,7 +99,7 @@ Verify the fix on the next host reboot. ## 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) - [architecture](/tools/gitea/architecture.md) — network topology - [data-persistence](/tools/gitea/data-persistence.md) — backups