Learn more about Russian war crimes in Ukraine.

Don’t use the word ‘it’

I recently discovered a magic rule for instantly clarifying your technical writing: don’t use the word “it”.

I very frequently use the word “it” when writing, in order to refer to something previously mentioned. The hope is that, in the reader’s mind, the word “it” resolves to the same thing I am thinking of, because context demands that the word couldn’t sensibly resolve to anything else.

Unfortunately, the reader is not as telepathic as I tend to assume. I know this because I am often my own reader: some time later, I re-visit and re-read my notes, only to find that these notes are not as clear as I had imagined when writing them. To decipher which thing is referred to by “it”, the reader must understand everything that has been written up to that point. This understanding is the context which is necessary in order to disambiguate the word. The word is resolved semantically rather than syntactically. As the reader continues, the job gets harder: more candidates for “it” are introduced, and the certainty required to disambiguate them slowly dissolves.

There is a simple solution: avoid the word “it”. Instead, refer to the referent explicitly.

This rule actually applies to a bunch of “it”-like words:

What can computers do? What are the limits of mathematics? And just how busy can a busy beaver be? This year, I’m writing Busy Beavers, a unique interactive book on computability theory. You and I will take a practical and modern approach to answering these questions — or at least learning why some questions are unanswerable!

It’s only $19, and you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

After months of secret toil, I and Andrew Carr released Everyday Data Science, a unique interactive online course! You’ll make the perfect glass of lemonade using Thompson sampling. You’ll lose weight with differential equations. And you might just qualify for the Olympics with a bit of statistics!

It’s $29, but you can get 50% off if you find the discount code ... Not quite. Hackers use the console!

More by Jim

Tagged . All content copyright James Fisher 2016. This post is not associated with my employer. Found an error? Edit this page.