Problem
Multiple markdown files across the repo use generic names like README.md, making them hard to distinguish in editor tabs, search results, and file listings. There's no consistent naming convention for documentation files.
Examples
starters/beginner/README.md, starters/intermediate/README.md, starters/llm/README.md — all show as "README.md" in tabs
docs/ has a mix of styles: new_architecture.md, issue_60_ldx_refactor_plan.md, learner_developer_experience.md, dev_tools.md
- Some docs are implementation plans/summaries that may not belong as permanent documentation
Scope
This is an open-ended housekeeping issue. Possible actions include:
Notes
Low priority — pick this up when doing a docs cleanup pass. The starter README.md files have a valid argument for keeping the name (GitHub auto-renders them, users expect the convention), so this should be a deliberate decision, not a blanket rename.
Problem
Multiple markdown files across the repo use generic names like
README.md, making them hard to distinguish in editor tabs, search results, and file listings. There's no consistent naming convention for documentation files.Examples
starters/beginner/README.md,starters/intermediate/README.md,starters/llm/README.md— all show as "README.md" in tabsdocs/has a mix of styles:new_architecture.md,issue_60_ldx_refactor_plan.md,learner_developer_experience.md,dev_tools.mdScope
This is an open-ended housekeeping issue. Possible actions include:
GUIDE.md,getting_started.md, or keepREADME.md)docs/for files that are implementation artifacts vs. actual documentationissue_60_ldx_refactor_plan.md,ldx_refactor_implementation_summary.md)Notes
Low priority — pick this up when doing a docs cleanup pass. The starter
README.mdfiles have a valid argument for keeping the name (GitHub auto-renders them, users expect the convention), so this should be a deliberate decision, not a blanket rename.