Skip to content

docs: simplify README into landing page#22

Merged
tuanhung303 merged 1 commit intomasterfrom
feat/readme-simplify
Feb 9, 2026
Merged

docs: simplify README into landing page#22
tuanhung303 merged 1 commit intomasterfrom
feat/readme-simplify

Conversation

@tuanhung303
Copy link
Owner

Summary

  • Rewrite README from 860 → 291 lines (~65% reduction) with ELI5 hook and Before/After visual proof
  • Extract deep content into 4 new dedicated docs: CONFIGURATION.md, API_REFERENCE.md, AUTO_SUPERSEDE.md, TROUBLESHOOTING.md
  • Add mermaid diagrams (Context Flow + Plugin Hook Architecture) to docs/ARCHITECTURE.md
  • Fix 2 broken links in AGENTS.md (CONTROLLED_CONTEXT_ARCHITECTURE.md, STATUS_BAR_BEHAVIOR.mddocs/ARCHITECTURE.md)
  • Preserve Known Pitfalls anchor (id="-known-pitfalls-for-agents") for AGENTS.md compatibility

New README Structure

Section Lines Purpose
Header + ELI5 hook ~10 Why you need this
Before/After ~20 Visual proof
Quick Start ~10 One config snippet
Features ~8 6 bullet points
Configuration ~15 Preset table + link
Documentation hub ~10 Links to all docs
Provider Compat ~10 5-row checkmark table
Contributing/License ~5 One-liners
Known Pitfalls (collapsed) ~155 Preserved for agents

No code changes — docs only.

- Rewrite README from 860 → 291 lines with ELI5 hook and Before/After visual
- Extract config, API, auto-supersede, troubleshooting to dedicated docs/
- Add mermaid diagrams to docs/ARCHITECTURE.md
- Fix 2 broken links in AGENTS.md
- Preserve Known Pitfalls anchor for AGENTS.md compatibility
@tuanhung303 tuanhung303 merged commit 0466c0f into master Feb 9, 2026
3 of 4 checks passed
@tuanhung303 tuanhung303 deleted the feat/readme-simplify branch February 9, 2026 23:36
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant