in reply to Re^2: The problem of documenting complex modules.(Summation.)
in thread The problem of documenting complex modules.

far outweighed by the complete lack of any semantic meaning to the resulting documentation.
the resulting volume of brutalist formal data churned out by such auto-documenters is enough to send anyone scurrying for sanctuary.

The worst part in my experience is that their use serves as a ready justifiction for not providing anything else.

It's like a car manufacturer supplying dealers with a comprehensive parts list, in place of Workshop manuals.

No other industry would get away with the practice.

With the rise and rise of 'Social' network sites: 'Computers are making people easier to use everyday'
Examine what is said, not who speaks -- Silence betokens consent -- Love the truth but pardon error.
"Science is about questioning the status quo. Questioning authority".
In the absence of evidence, opinion is indistinguishable from prejudice.
I'm with torvalds on this Agile (and TDD) debunked I told'em LLVM was the way to go. But did they listen!
  • Comment on Re^3: The problem of documenting complex modules.(Summation.)

In Section Meditations