MAKE THE PROJECT LEGIBLE
Keep Documentation in Sync With Code
Documentation is part of the implementation, not a retrospective task.
Useful workflow
Discuss→Decide→Implement→Test→Update Documentation
After meaningful changes, update architecture notes, decision logs and known limitations.
Takeaway
A change is not finished until the documentation matches it.