25Be Rabid about Readability

In this book I advocate using a general approach to creating content that's more relaxed and less filled with jargon, buzzwords, and clichés. In general, the best Web writing isn't necessarily short, but it is simple, with…

  • img shorter paragraphs with no more than three sentences or six lines (and just one is fine).
  • img shorter sentences with no more than 25 words in a sentence.
  • img straightforward words—in other words, avoid clichés, jargon, and buzzwords (for example, avoid utilize when you can write use, instead).

So…

  • img Use bulleted or numbered lists.
  • img Highlight key points (like this one), either in bold or italic, or as a pull quote.
  • img Use subheadings to break up text.
  • img Add visual elements, such as graphics, photos, slide shows, and so on.
  • Use lots of white space ...

Get Everybody Writes: Your Go-To Guide to Creating Ridiculously Good Content now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.