Category Archives: Writing

Avoid Double Negatives Like the Plague

Double negatives are very confusing. They probably classify as one of the most confusing things in written or spoken communication, if not as the one, most confusing thing ever.

A particularly striking example of a double negative that I’ve seen in the wild is:

gutter (true/false) — If false, the line numbering on the left side will be hidden. Defaults to true.”

WordPress Documentation
Source Code Posting Instructions

Now read quickly through the help of the “gutter” option, and then try to answer the following questions:

  • Can you understand immediately if setting gutter=true hides or shows the line numbering bits?
  • Is it entirely obvious why the default is true, with just a quick glance at this sentence?

The reason why the original sentences are confusing is that there’s a hidden double negative right in the middle of the first sentence. The combination of “false” and “hidden” works against the intention of the documenter, muddling the waters and effectively hiding the real information behind a barrier of miscommunication. The reader must first scale the obstacle of noticing the false-hidden combination; then read the following sentence; realize that this works as a negation of something that is true by default; combine all bits together to form an actual understanding of what the gutter option is all about.

The larger the context we have to keep in our head, the more difficult it is to understand the actual meaning. More importantly, this is true for both written and spoken communication. The double negative in the first of these sentences renders the first sentence difficult to parse and leaves the reader hanging for more context, provided much later then necessary, by the second sentence of the group.

Rewriting the first sentence, to remove the double negative, vastly improves our ability to grasp its meaning with one glance:

gutter (true/false) — Show line numbers on the left side. Defaults to true.”

As a bonus point the first sentence is now smaller too. Removing the noisy and confusing double negative — which, amusingly enough, had the gall to mask as an attempt to “clarify” things — resulted in a more compact, but also cleaner, easier to read sentence; one with arguably higher informational content!

The Adobe Caslon font

One of the fonts I recently discovered and started enjoying a lot is Adobe Caslon. Here’s a small sample of what it looks at 600 dpi, rendered from XeLaTeX. The text sample is from “Advice to Little Girls”, a humorous short story written by Mark Twain in 1867.

Adobe Caslon sample (600 dpi)

The more I look at text typeset with Caslon the more I like the round, elegant shapes of the characters (despite the “serif” style of the font); the beautiful ligatures of “ff”, “fi”, and “fl”; the clear-cut serifs of the upper part of high glyphs; the punctuation marks that stand out out with their brightly distinct shapes (note the full stop characters, the commas, and the quotation marks near “chewing-gum”).

Then vs. Than

Scribd has many online books. I try to read at least one book every week. Starting to read a new book is always fun. The sense of anticipation builds up while the search for a new book is still in progress. The novelty of the new text reaches out of the first few pages, trying to grab my attention. Then there are times that something like the following jumps out of the page to annoy me:

Object-oriented programming is the current cure-all — although it has been around for much more then ten years. At the core, there is little more to it then finally applying the good programming principles which we have been taught for more then twenty years.

— Object Oriented Programming in C

Continue reading