Skip to content

Yahoo! Style Guide book review

No matter what you think of Yahoo! it’s been around a long time.

Founded in 1995, the site remains one of the most popular destinations on the web.

In 2015, Alexa rated Yahoo! #5 in the world, calling it “a major internet portal.” It also features many services and a ton of content.

Clearly the company’s writers and editors have a ton of experience creating webpages, blogs, e-mail and user interfaces.

Yahoo! Style Guide book cover

Now this knowledge has been gathered together in The Yahoo! Style Guide: The Ultimate Sourcebook for Writing, Editing, and Creating Content for the Digital World.

At 512 pages, it’s a doozie, packed with useful tips and best practices. And much of what it suggests applies just as well to white papers.

How-to tips for white paper writers

For example, on page 10 it tells how to test the readability of your text with Word.

I do this routinely for all my white paper drafts. Yet many writers don’t even know this feature exists, nor how to interpret the readability statistics that Word spits out in a few seconds.

On page 22, it describes how to create a persona for your target audience, calling this by the friendlier term “model user” and providing a worksheet to fill in.

I find creating a persona or two can be a very useful exercise to help keep a major white paper on track.

And on page 31, it describes in detail how to develop a specific “voice” for a website, with many examples that explain attributes, formality, and tone.

Being able to control your voice, and vary it according to the requirements of different clients, is the mark of an accomplished professional writer.

Before and after rewrites

Another compelling feature of this guide is a number of “before” and “after” examples. Each one shows how to rewrite some tired or outdated text into more muscular, easy-to-scan prose.

Some of these rewrites aim to create pages that work better for mobile devices or web visitors. Others will interest white paper writers, as they show how to cut the flab, use bullets effectively, and get to the point.

Writing, grammar, and technical tips

There’s also a seven-page list of verbose phrases you can trim, and a table of deadwood words you can drop.

And finally?! Someone who still knows what phrases like “begging the question” and “gilding the lily” are supposed to mean, and how to use them properly.

Plus, a clear description of the difference between “that” and “which” and when to use each one. Somehow I missed that day in English class.

And, there’s a cool suggestion to think of the commas around any clause starting with “which” as dotted lines that show where you can cut. Brilliant!

Beyond these gems, there are all the chapters you would expect on abbreviations and punctuation, and surprise chapters on basic HTML, SEO, UI text and copyright.

The entire book is a model of clarity, with examples for every point, and even some exercises sprinkled throughout to help emphasize certain points.

40 pages of pesky words

The guide is topped off by a 40-page list that shows how Yahoo! editors deal with troublesome terms like:

  • 24/7 (note slash)
  • C02 (subscript 2 not recommended online)
  • do’s and don’ts (note apostrophes)
  • 800GB (for gigabytes, note no space)
  • Linux (note initial cap only)
  • NASCAR but Nasdaq (note caps)
  • site map (two words)
  • sync but synched (the “h” helps readers get it)
  • toward (American) but towards (British)
  • UNIX (note caps)
  • ZIP code (note caps)

You don’t have to agree with how they handle every term, but it’s great to see the rationale behind it, and consider if you want to follow along.

Well-worth picking up

All in all, the The Yahoo! Style Guide is impressively clear and thorough, and well worth picking up for any writer or editor. At press time, you could pick up a used hardcover copy from Amazon for less than $10.

At that price, it’s an easy investment to make.

If you’re a marketing manager, you can use the Yahoo! Style Guide to help create your own corporate standards, and to train any new writers you add to your team.

Want to hear whenever there’s a fresh article on this site? Subscribe here to stay in the know on long-form content. From time to time, we’ll also send you word about some great new resource or training. And you can unsubscribe any time.  

About Gordon Graham

Worked on 300 white papers on everything from choosing enterprise software to designing virtual worlds for kids, for clients from Silicon Valley to Switzerland, from household names like Google and Verizon to tiny startups with big ideas. Wrote White Papers for Dummies which earned more than 50 5-star ratings on Amazon. And named 2019 Copywriter of the Year by AWAI, the world's leading training organization for professional copywriters.

If you liked this post...

Countdown to midnight. Retro style clock counting last moments before Christmas or New Year 2018.

A few of my favorite things; a look back at 2017

Here's a few of my favorite things from 2017. After all, there's more to life...
Book Library University Education Research Bookshelf Studying

That White Paper Guy’s list of recommended books on writing white papers (and everything else)

Writers buy a lot of books. That makes sense, right? My favorite books on copywriting, content marketing,...
Cover of The Elements of Style

The Elements of Style book review

The earliest edition of The Elements of Style was set down 100 years ago in...

Leave a Comment