Let's say the docs present a simplified view of reality... :-)
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
Putting it to work
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
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 Let us be charitable, and call it a misleading feature :-)
Permalink to quote #18 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
It's documented in The Book, somewhere...
Larry WallLarry Wall quote #14 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 Reading computer manuals without the hardware is as frustrating as reading sex manuals without the software.
Arthur C. ClarkeArthur C. Clarke quote #20