Language and grammar

Writing well is hard. You need to know when to capitalize, when to abbreviate, when to use "one" and "1" and "compliment" and "complement" (to say nothing of actually getting your point across using the appropriate voice and tonearrow-up-right). We'll cover some especially hot topics in this section, but we have neither the space nor inclination to get down to brass tacks on every last thing. Consider this chapter more of a guide to our in-house style. Everything you learned in high school still applies. These are just some things that crop up often and merit a bit of extra attention.

Further reading: If you really want to nerd out on this stuff, The Elements of Stylearrow-up-right, Grammar Girlarrow-up-right, and the New Yorker's Comma Queen video blogarrow-up-right (yes, really) are excellent resources. Or you can just install Grammarlyarrow-up-right and call it a day. 😉

General guidelines

  1. Have something to say. This may seem obvious, but it bears mentioning. Without something to say, you'll end up with sentences that sound meaningful but ultimately amount to nothing. Read widely, take notes, choose your points thoughtfully. Then start writing.

  2. Use simple words and short sentences. As George Orwell said: "Never use a long word where a short one will do." The same goes for sentences. Research shows that people understand less the more you writearrow-up-right, so try to keep sentences to 25 words or less.

  3. Focus your message. No matter how good a piece of content is, most people will only read about 25% of itarrow-up-right. Lead with the most important information to ensure it gets read.

  4. Cut the fat. The best writing is lean, clear, and concise. Modifiers like "very" and "a bit" add less than you think and often suck the life out of sentences. Reserve a round of edits for these unnecessary filler words and phrasesarrow-up-right.

  5. Be open and receptive to feedback. Everyone (yes, everyone) writes crappy first drafts. The beauty of writing is that it's iterative. Write a draft, gather feedback, revise, and polish to a sheen.

Last updated