You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
chore: rename docs/specs/SPEC.md and faces.md to .adoc #96
The estate documentation-format rule (DOC-FORMAT in .claude/CLAUDE.md) is:
All documentation files in docs/ must use .adoc extension.
Exception: GitHub community-health files must use .md by name (CONTRIBUTING.md, CODE_OF_CONDUCT.md, SECURITY.md, CHANGELOG.md, README.md).
Two files in docs/specs/ on main predate this rule and still use .md. Neither matches the community-health exception.
Grep the rest of the repo for inbound references to the old .md paths and update each one (e.g. docs/specs/SPEC.md referenced from other specs, READMEs, justfiles, CI scripts, the bin/main.ml --help blurb if applicable).
Acceptance
Both files renamed and rewritten in valid AsciiDoc.
git grep -nE 'docs/specs/(SPEC|faces)\.md' returns no hits except in CHANGELOG-style historical notes.
The PR body lists every inbound reference touched.
Why this is good-first-issue
The conversion is mechanical, the rule is documented in .claude/CLAUDE.md (DOC-FORMAT), and docs/specs/affex-spec.adoc (landed on PR #93's branch) is a worked example of the same Markdown → AsciiDoc conversion at this scale.
Out of scope
Do not touch any open PR's branch as part of this work — SPEC.md and faces.md show up in several open PRs' diffs and renaming them mid-PR creates merge churn. Wait for those PRs to merge or be closed, then do this rename in a single small PR against main.
Activity