Context
docs/design-docs/ contains rich historical blueprints that can mislead newcomers. A documentation index (docs/README.md) was added to distinguish active vs historical docs — verify completeness and cross-links.
Objectives
Files
docs/README.md
CONTRIBUTING.md
- Optional:
docs/design-docs/README.md
Getting started
- Read
docs/design-docs/CODE_SCAFFOLD.md banner text for tone
- Walk the
docs/ tree and confirm the index matches reality
Out of scope
- Rewriting historical design docs
Definition of Done
- All links resolve
- Optional
CHANGELOG.md ### Added for docs index
Context
docs/design-docs/contains rich historical blueprints that can mislead newcomers. A documentation index (docs/README.md) was added to distinguish active vs historical docs — verify completeness and cross-links.Objectives
docs/README.md: active vs historical table is accurateARCHITECTURE.md,logseq_ast_primer.md,GOOD_FIRST_ISSUES.mdCONTRIBUTING.mdDocumentation section (if missing)docs/design-docs/README.md(new stub) pointing todocs/README.mdFiles
docs/README.mdCONTRIBUTING.mddocs/design-docs/README.mdGetting started
docs/design-docs/CODE_SCAFFOLD.mdbanner text for tonedocs/tree and confirm the index matches realityOut of scope
Definition of Done
CHANGELOG.md### Addedfor docs index