RE: https://mastodon.social/@glyph/117492247582285909
This. And document everything.
Force programmers to think further about how we design systems.
Provide context for those who don't have access to the creators' minds (including our future forgetful selves).
Code is read more often than it is written.
The more code there is involved in a system, the more reading must be done.
Therefore the most important change control to implement in any system which will see long-term maintenance is to rate-limit the addition of new code to keep reading easy.