Most docs rot because they live outside the code. I keep documentation next to the code, in PRs, and added to every relevant ticket.
My daily flow
- Every doc follows a template: context, configuration, run commands, known pitfalls.
- The template is attached to the PR that touches the feature.
- I auto-sync the content with Notion or other tools when needed.
Documentation evolves with the code, so the team never needs to guess parameters or search for missing instructions. The git history keeps a precise record of every change.