“One of the hardest things to track during the life of a project is the motivation behind certain decisions.”
Similar to Python’s PEP approach to documenting decisions.