Skip to content

Point the observer comments at the doc's current name - #228

Open
monthop-gmail wants to merge 1 commit into
cloudflare:mainfrom
monthop-gmail:fix-observers-doc-reference
Open

Point the observer comments at the doc's current name#228
monthop-gmail wants to merge 1 commit into
cloudflare:mainfrom
monthop-gmail:fix-observers-doc-reference

Conversation

@monthop-gmail

Copy link
Copy Markdown

What does this change?

Four comments in overseer.ts cite observers-implementation-plan.md, but the file is checked in as docs/observers.md — so following the reference finds nothing. I hit this while reading ensureObserver() and went looking for a file that isn't there.

Retargeted all four, matching how blueprint-archive.ts already cites docs/blueprints.md:

line now cites
397 docs/observers.md §3
2761 docs/observers.md §5 Step 5
6046 docs/observers.md §5 Step 6
6092 docs/observers.md §5 Step 3

Why is this obviously correct and trivially verifiable?

The patch is four comment lines; no code changes, so behaviour cannot move.

Both halves are checkable from the tree alone:

  • docs/observers.md exists and observers-implementation-plan.md does not.
  • Every cited section still exists under the new name — ## 3. Concepts & terminology, ### Step 3, ### Step 5, ### Step 6 — so each reference resolves to the passage it was always pointing at.

Checklist

  • This is a small, concrete change; it is not a feature, refactor, or low-value cleanup.
  • I understand that maintainers decide whether the change is obviously correct and trivially verifiable.
  • I have read and followed the contribution guidelines.

🤖 Generated with Claude Code

Four comments in overseer.ts cite observers-implementation-plan.md, but that
file is checked in as docs/observers.md, so following the reference finds
nothing. Retarget them, matching how blueprint-archive.ts cites docs/blueprints.md.

Every cited section still exists under the new name: §3 "Concepts &
terminology", and §5 "Step 3", "Step 5" and "Step 6".

Comments only; no code changes.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the kernel Changes to the Workshop kernel label Aug 16, 2026
@github-actions

github-actions Bot commented Aug 16, 2026

Copy link
Copy Markdown

All contributors have signed the CLA ✍️ ✅
Posted by the CLA Assistant Lite bot.

@monthop-gmail

Copy link
Copy Markdown
Author

I have read the CLA Document and I hereby sign the CLA

github-actions Bot added a commit that referenced this pull request Aug 16, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

kernel Changes to the Workshop kernel

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant