Skip to content
quotesby

About this quote

What does it mean?
The source code must be useful, so it won’t be omitted from the book.
In plain terms
Useful code is always documented.
What can you take from it?
Make code purposeful and readable.

Where it applies

  • writing libraries
  • maintaining projects

Putting it to work

  • add comments
  • provide examples

Questions to consider

  • What makes code useful enough to document?
  • How do you balance brevity and clarity?

Another view

Not all useful code gets proper documentation.

More from Larry Wall

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

    Permalink to quote #14
  2. 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
  3. It's all magic. :-)

    Permalink to quote #13

Related quotes

  1. History a distillation of rumor.

    Thomas CarlyleThomas Carlyle quote #62
  2. Quoted in Representative Men: Uses of Great Men by Ralph Waldo Emerson

    Napoleon BonaparteNapoleon Bonaparte quote #205
  3. That being said, I think we should immediately deprecate any string concatenation that combines '19' with '99'. :-)

    Larry WallLarry Wall quote #226