Documentation has a new reader and why it should belong inside the codebase
AI is now a reader of your documentation. When context lives outside the repository, gaps appear and assumptions creep in. Moving documentation closer to the code makes the system easier to reason about, for people and for machines.