News for hackers. Stuff that matters.
Re:Healthy Self-Doubt by bsder on Saturday July 11, 2020 @07:29PM (#23807134)
Then that's poor documentation.

Documentation, like comments, is most useful when it answers "why" sometimes "how" but rarely "what". And "why" changes much more slowly.

It's why I find API documentation to border on useless. I need examples and rationale, not variable names.

There are no comments on this comment yet.