Back to archive

Thread

3 tweets

1
It’s funny how some ideas seem to just catch on. My guess: ‘self documenting code’ was a good excuse for people working under bureaucratic documentation rules to stop following them. Reality, as always is more nuanced.
2
@paul_rietschka BTW, an interesting observation I made is that open source code bases are often much better documented than corporate ones. The reason? As OSS, you want to make it as accessible as possible so that others can contribute (cynically, free labor).
3
@paul_rietschka On the other hand, in companies you document for yourself if your wise, but isn‘t it management who wants to make sure someone can work on the codebase after people left? Ok, maybe also a bit cynical.