Skip to content

spec 010 D0 cleanup: probe key removed, both mechanisms measured - #79

Merged
iancooper merged 1 commit into
masterfrom
docs/spec-010-d0-cleanup
Aug 7, 2026
Merged

spec 010 D0 cleanup: probe key removed, both mechanisms measured#79
iancooper merged 1 commit into
masterfrom
docs/spec-010-d0-cleanup

Conversation

@iancooper

Copy link
Copy Markdown
Member

Closes out D0. The probe key promised for removal in #78 comes out here.

Both halves answered

Question Answer
Does GitBook auto-redirect a Git-synced SUMMARY.md rename? Yes — 307 within 25s of #77, with no redirects block in the repo
Are .gitbook.yaml redirects read on this site, and does the plan permit them? Yes — the probe key began redirecting after #78; a control key absent from the block kept 404ing

The control is what makes the second a measurement rather than a hope.

Fingerprint

Cached responses all report 200, so status alone proves nothing. The discriminators:

Path class location: header Body
probe key in the block 1 192,328
key not in the block 0 189,517 (404 shell)
renamed-away path (automatic) 1 192,373
real page 0 584,460

The finding worth more than either

The redirect value is a repository path, and GitBook resolves it to wherever that page currently publishes. The probe pointed at contents/CommandsCommandDispatcherandProcessor.md and landed on commands-processors-and-dispatchers/… — the post-rename URL. So a redirect entry does not go stale when its page moves again, which matters for a spec that will move some pages more than once.

What stays

The real redirect for #77's rename, as a safety net. Nothing yet establishes that automatic redirects persist over time — they may be tied to revision history, and one session cannot test that.

Re-verified after the edit: zero bytes outside printable ASCII, parses as YAML, structure: intact, target exists, no leading slashes.

🤖 Generated with Claude Code

https://claude.ai/code/session_012tcdwxVb8NmKaX2S6fvyFg

D0 is complete and both halves are answered.

GitBook automatically redirects a Git-synced SUMMARY.md rename. The old path
returned 307 to the new one within 25 seconds of #77 merging, with no redirects
block anywhere in the repo.

.gitbook.yaml section-level redirects are also read and honoured, and the site
plan permits them. The probe key — a path that had never existed and returned 404
— began redirecting after #78 published, while a control key absent from the block
kept 404ing. That control is what makes it a measurement rather than a hope.

An extra finding worth more than either: the redirect VALUE is a repository path,
and GitBook resolves it to wherever that page currently publishes. The probe
pointed at contents/CommandsCommandDispatcherandProcessor.md and landed on
commands-processors-and-dispatchers/..., the post-rename URL. So a redirect entry
does not go stale when its page moves again — which matters for a spec that will
move some pages more than once.

The probe key has done its job and is removed. The real redirect for #77's rename
stays as a safety net, since nothing yet establishes that automatic redirects
persist over time.

Verified again after the edit: zero bytes outside printable ASCII, parses as YAML,
structure block intact, target exists, no leading slashes.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012tcdwxVb8NmKaX2S6fvyFg
@iancooper
iancooper merged commit 06c9e62 into master Aug 7, 2026
6 checks passed
@iancooper
iancooper deleted the docs/spec-010-d0-cleanup branch August 7, 2026 18:48
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant