Simple: ask "why" in a PR review, put the answer in a code comment. If there is a bigger / higher level "why", add it to git commit description. This way it's a

Simple: ask "why" in a PR review, put the answer in a code comment. If there is a bigger / higher level "why", add it to git commit description. This way it's auto-maintained with code, or stays frozen at a point in time in a git commit. More: https://max.engineer/reasons-to-leave-comment https://max.engineer/reasons-to-leave-comment Much more: https://max.engineer/maintainable-code https://max.engineer/maintainable-code