in reply to Re: The problem of documenting complex modules.
in thread The problem of documenting complex modules.

Sounds like we are pretty much in accordance. Do you have any specific examples of (somewhat complex) modules you use regularly that either were:

  1. really easy to get started with despite their complexity.
  2. Or really tough to get started with; but you persisted because you needed their functionality.
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^2: The problem of documenting complex modules.

In Section Meditations