Why is code something you ‘wade’ in, while documentation is not?
I mean, maybe I’m being obtuse, but to me they’re both text. Documentation is useful if it tells me something the code doesn’t, or gets me to a truth about the code faster. Documentation that repeats the code is redundant.
Documentation that repeats the code is redundant.
Is wasting the reader’s time not also rude?
(This is not an ‘our documentation is good enough’ argument, to be clear! Nor is it a ‘documentation is not as important as code’ argument. Good documentation is essential, and we have plenty of room to improve. But good documentation IMO is not the same as maximalist documentation.)