docs: finish cannibalising the retired docs repo - #6
Merged
Conversation
The final gap from a phrase-level audit of the retired docs repository: its STYLE enumerated the spelling exceptions, and the fold into this repo's STYLE kept only the code-identifier one. The dropped items — quoted text, proper nouns, and LICENCE / CODE_OF_CONDUCT excluded as legal and upstream text — are exactly what check-british-spelling.sh already excludes, so the document was under-describing its own enforced tool. Restored, and tied to the script's ALLOWED_PATTERNS so the two cannot drift. With this, the retired docs repository is fully cannibalised: a shingle diff of every prose file against the whole kernel tree now shows nothing of substance present there and absent here. Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
An exhaustive re-audit (file-by-file plus git-history, not just the earlier
prose shingle diff) found three genuine omissions the shingle pass had
skipped because it ignored config files, tables, and the PR template. All
now folded; with these the retired repository holds nothing of substance
that is absent here.
- PR template gains "If this changes a document or the constitution": the
amendment guidance the docs repo's own template carried and the
code-first kernel template lacked — state what an amendment supersedes
and invalidates, leave no stale clause, renumber no cited section, log
it in the changelog. Bonus fix in the same file: its CLAUDE.md section
references, stale since the CONSTITUTION.md rename, are all corrected.
- .gitignore ignores book/ and _site/ — the mdBook / Pages render output
RFC-0002 commits to at Phase 4, so a first local render cannot be
committed by accident.
- .gitattributes marks *.pdf binary.
Provenance was verified too: all eleven docs-repo commits are ancestry of
main except the retirement-banner commit, which correctly lives only in the
retired repo. Nothing was discarded.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
MatejGomboc
changed the title
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
You asked me to double-check nothing useful was discarded from the retired
setonix-os/docsrepo. I re-audited exhaustively — file-by-file (config, tables and the PR template included, which the earlier prose-only shingle diff had skipped) and git-history for provenance.Provenance: all 11 docs commits are ancestry of
mainexcept the retirement-banner commit, which correctly stays only in the retired repo. No history lost.Content: three genuine omissions found and folded here; the constitution itself was verified to have zero dropped clauses (every docs-only line was reworded-in-place or superseded by newer kernel text):
CLAUDE.mdreferences — stale since the rename — are all corrected toCONSTITUTION.md..gitignore—book/and_site/, the mdBook/Pages render output RFC-0002 commits to at Phase 4..gitattributes—*.pdf binary.Also still includes the original commit of this PR: restoring the British-spelling exceptions list to
STYLE.md.Everything else the audit surfaced was reworded-in-place, superseded, or docs-repo-specific framing. The retired repo now holds nothing of substance absent here.
Which pillar does this serve?
None — documentation completeness toil (§5.3).
unsaferegisterunsafeblocks: NoneChecklist
docs/CHANGELOG.mdupdated🤖 Generated with Claude Code