I've written about this and some of the ideas being discussed here. Essays that I'm reasonably proud of: https://notoriousbfg.com/building-software-sharing-kno

I've written about this and some of the ideas being discussed here. Essays that I'm reasonably proud of: https://notoriousbfg.com/building-software-sharing-knowledge https://notoriousbfg.com/building-software-sharing-knowledge https://notoriousbfg.com/code-and-context https://notoriousbfg.com/code-and-context TLDR: I don't think that poorly written code is as common as devs like to thing it is. Context is just as important in our general perception of how well some code has been written/designed. There are several ways we can and should document our code including descriptive variable and method names, commit messages, tests and PR comments.