docs: publish manifest + wiki page mapping, with a coverage check (#12) #18
No reviewers
Labels
No labels
needs-info
needs-triage
ready-for-agent
ready-for-human
wontfix
needs-info
needs-triage
ready-for-agent
ready-for-human
review/merge-ready
review/needs-fix
review/needs-human
review/needs-review
wayfinder:grilling
wayfinder:map
wayfinder:prototype
wayfinder:research
wayfinder:task
wontfix
No milestone
No project
No assignees
1 participant
Notifications
Due date
No due date set.
Dependencies
No dependencies set.
Reference
olympus/infra-forge!18
Loading…
Add table
Add a link
Reference in a new issue
No description provided.
Delete branch "hermes/12-wiki-publish-manifest"
Deleting a branch is permanent. Although the deleted branch may continue to exist for a short time before it actually gets removed, it CANNOT be undone in most cases. Continue?
Part of #7. Closes #12.
Makes the publish decision explicit:
docs/wiki-pages.ymlis the in-repo manifest, allowlist by default, carrying the exclusions. No sync, hook, workflow or role change — the wiki sync is #2's scope.What lands
The manifest
Allowlist by default: a document is published only if
publishlists it, and every document not published is named underexclude. Entries are repo paths — the wiki page each becomes is the sync's business, not this file's.docs/agents/is excluded. Mirror semantics are recorded: a page exists only while its source is listed, so deleting a source deletes its page.Evidence
docs/(plus the glossary) are either published or excluded.tofu fmt -check -recursive tofu/clean; no tofu or ansible file touched.README.md, the docs tree andGLOSSARY.mdresolve.Review
Addressed the three inline comments: dropped the wiki bullet from
docs/index.md(the manifest explains itself and is not itself published), dropped the future-work mention from the manifest header, and reducedpublishto bare file paths.Merge Danger
Door: one-way for the wiki-sync work (#2), which now has a manifest to read; nothing for the running stack.
Blast Radius: one new document-mapping file. No sync, hook, workflow, or role change.
0fcc2214cdto0f38bd4ee20f38bd4ee2tofa0d0dc295@ -21,3 +21,7 @@ here.- Every relative link resolves inside the repo. Nothing here links out to theREADME, and the README does not link in here yet.- The glossary is a glossary: definitions only, no procedures.- What reaches the wiki is decided here, not in the sync: `wiki-pages.yml`Remove. Wiki pages is not published itself. And it already contains a comment explaining what is for and how it works
@ -0,0 +6,4 @@# has to land a matching change here. The manifest lives in the repo, not in# the sync, so a human edits the decision and the sync reads it.## The sync that consumes this file is the wiki-sync work (issue #2); nothingRemove mention of future work here.
@ -0,0 +20,4 @@# gone is simply absent, with no per-file removal to remember.publish:docs/index.md: HomeOnly need file path (key). Value can be droped
fa0d0dc295toa4b6dd5d67Addressed all three:
docs/index.md— remove the wiki bullet: gone. The file is back to its pre-#12 state (it is now absent from the diff entirely) — the manifest carries its own explanation and is not itself published.docs/wiki-pages.yml:9— remove the future-work mention: the header no longer names #2; it just states the manifest lives in the repo and is read by the sync.docs/wiki-pages.yml:23— drop the values:publishis now a bare list of repo paths. The page-name mapping moved out of the file — the wiki page each source becomes is the sync's business.Rebased onto current
main(aa7cf9b, which brought the glossary update and the worktree gitignore). PR is now a single new file,docs/wiki-pages.yml, +30/-0.