[hinkley]

When I'm looking at code, I don't want to read War and Peace.

But I also don't want to read Haiku either. All the burden is on the reader, and there are many readers.

Usually what I want is a short story. Long enough to be accurate, short enough to lose distracting and unnecessary information.