From b9ed0aa4fb1aced33bcd3fcf61ee1b438f5f8246 Mon Sep 17 00:00:00 2001 From: Chris Sells Date: Fri, 17 Jul 2026 18:56:33 -0700 Subject: [PATCH] docs(recovery): reduce the stub to a pure pointer MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The per-section forwarding map mirrored the live playbook's structure — a copy that would drift as docs/recovery/ evolves. A stub carries nothing to maintain: one pointer to the live playbooks plus the reason the file exists. Deep anchors from the wild land at the top of the page, where the pointer is the first thing a reader sees. --- docs/RECOVERY.md | 33 ++++++++------------------------- 1 file changed, 8 insertions(+), 25 deletions(-) diff --git a/docs/RECOVERY.md b/docs/RECOVERY.md index bfca1b4be..7334f0fd4 100644 --- a/docs/RECOVERY.md +++ b/docs/RECOVERY.md @@ -1,30 +1,13 @@ # Recovery Playbooks -This playbook moved to [docs/recovery/](recovery/index.md), rendered on the -docs site at [https://beads.gascity.com/recovery/](https://beads.gascity.com/recovery/). Everything that lived on -this page is now in [recovery/init-safety.md](recovery/init-safety.md) -([https://beads.gascity.com/recovery/init-safety](https://beads.gascity.com/recovery/init-safety)). +The recovery playbooks moved to [docs/recovery/](recovery/index.md), rendered +on the docs site at +[https://beads.gascity.com/recovery/](https://beads.gascity.com/recovery/). > **Why this file exists:** released `bd` binaries print URLs into this file — > v1.1.0's Dolt merge-refusal guidance (`printAncestorPKMismatchGuidance`, -> `cmd/bd/dolt.go` at tag `v1.1.0`) prints -> `docs/RECOVERY.md#pk-fork-refused`. This stub keeps those printed links -> landing on a working page with the same anchors. Do not delete it while -> released binaries still print it; it is deliberately exempt from the -> no-pointer-stubs rule (see `test/docsync`). - -## init-force-refused - -Moved: [recovery/init-safety.md § init-force-refused](recovery/init-safety.md#init-force-refused) · [https://beads.gascity.com/recovery/init-safety#init-force-refused](https://beads.gascity.com/recovery/init-safety#init-force-refused) - -## init-token-missing - -Moved: [recovery/init-safety.md § init-token-missing](recovery/init-safety.md#init-token-missing) · [https://beads.gascity.com/recovery/init-safety#init-token-missing](https://beads.gascity.com/recovery/init-safety#init-token-missing) - -## init-local-exists - -Moved: [recovery/init-safety.md § init-local-exists](recovery/init-safety.md#init-local-exists) · [https://beads.gascity.com/recovery/init-safety#init-local-exists](https://beads.gascity.com/recovery/init-safety#init-local-exists) - -## pk-fork-refused - -Moved: [recovery/init-safety.md § pk-fork-refused](recovery/init-safety.md#pk-fork-refused) · [https://beads.gascity.com/recovery/init-safety#pk-fork-refused](https://beads.gascity.com/recovery/init-safety#pk-fork-refused) +> `cmd/bd/dolt.go` at tag `v1.1.0`) prints `docs/RECOVERY.md#pk-fork-refused`. +> This stub keeps those printed links landing on a page that points at the +> live playbooks. Do not delete it while released binaries still print it; it +> is a deliberate exception to the no-pointer-stubs rule, registered in +> `test/docsync`.