We Finally Care About Context
I was reviewing an older repository during a production incident the other day and couldn’t figure out what sections of the code were doing or what the overall system looked like. It’s so frustrating to be in undocumented code. Software documentation is a mature pillar of engineering these days. The tools are there, the patterns exist, the documentation standards are well-established. We just… don’t do it. Why don’t we when there is documented correlation between high performing engineering teams and open and accessible codebases? ...