The more experience I gain as a software developer the less tolerance I have for the idea that something doesn't need documenting if you can go and read the source code instead
(That's despite getting much, much better at reading source code to answer my own questions as I gain experience)
(That's despite getting much, much better at reading source code to answer my own questions as I gain experience)
Comments
If your code is clearly written and nothing else ever needs to call it then I don't particularly mind if there's no additional […]
I tend to lean toward a well-documented tool over one that’s intentionally designed for the sadomasochists.