Skip to content
quotesby

About this quote

What does it mean?
Simplified documentation presents a limited view of reality.
In plain terms
Docs give a simplified view.
What can you take from it?
Remember that docs are abstractions.

Where it applies

  • learning new APIs
  • reading manuals

Putting it to work

  • cross‑check with source
  • test assumptions

Questions to consider

  • How much trust should you place in docs?
  • When should you dig deeper?

Another view

Over‑simplification can mislead users.

More from Larry Wall

  1. Dan Smith: I've tried (in vi) 'g/[a-z] [a-z]/s//_/'...but that doesn't cut it. Any ideas? (I take it that it may be a two-pass sort of solution). Larry Wall: I…

    Permalink to quote #16
  2. Let us be charitable, and call it a misleading feature :-)

    Permalink to quote #18
  3. It won't be covered in the book. The source code has to be useful for something, after all... :-)

    Permalink to quote #15

Related quotes

  1. It's documented in The Book, somewhere...

    Larry WallLarry Wall quote #14
  2. I spent this time polishing up the software/hardware documentation, renaming registers to be more meaningful. This was actually time well spent in my life.

    Jay MinerJay Miner quote #3
  3. Reading computer manuals without the hardware is as frustrating as reading sex manuals without the software.

    Arthur C. ClarkeArthur C. Clarke quote #20