Docs directories are doomed
8 days ago
- #LLMs
- #documentation
- #context-management
- The /docs directory often starts small but grows organically, leading to issues like discoverability and doc rot.
- Key problems include ownership of docs, velocity mismatch in updates, lack of hierarchy, and bespoke doc structures.
- LLMs can't fully solve context management as context is about intent and real-world boundaries, not just code generation.
- Effective context management requires organization-wide ownership, navigability, composability, and code-awareness.
- Context-Driven Development (CDD) links context directly to code, creating a bidirectional relationship for better understanding and maintenance.
- CDD ensures context docs are a source of truth, tightly coupled with code, improving human understanding and product design.