Wednesday, July 28, 2010

3 Simple Basics to Great Web Writing: From a Fro Yo Menu


Look at the picture above. This is a perfect example of excellent Web writing.
Why? Because the call to action is crystal clear—they want you to buy yogurt and they make it simple and easy to do so. Look at the techniques they used to get you there:

1. Break text into simple steps or bullets: Notice how every step has its own couple of lines. Users reading online can easily absorb the information when it is organized like this. How users read on the Web is actually very, very little—they prefer to scan like crazy until they get to information they care about.

2. Use the same fonts for each level of text: In this sign, Step 1, Step 2 and Step 3 are all the same size. The words are different colors to make it even easier for the eye to differentiate between the steps—not necessary on the Web, but still an example of best practices for graphic design. A good Web writer will work with the Web development team to design a style sheet that will take into account different levels of h tags and the size of the font for each different level of headline--all the more important for SEO as well.

3. Keep it snappy and simple: Notice the description of the flavors. Yes, I'll wait while you go look in your freezer. Back? Ok, look at how they simply and easily convey what you need to know to buy. The brilliant author of this sign used:
• Language you understand and are familiar with (vanilla, chocolate, citrus)
• Short descriptions that are rich with adjectives
• Names with descriptions after semi colons, so that the reading comprehension part of your brain went into the “Oh, this is an explanation” mode

Who knew Mr. Yogato in Fell’s Point had such erudite marketers? Now go in there (if you're in Fell's Point--although apparently they have a location in D.C., though I can't vouch for whether or not they have the sign), and see if you can stand on 1 foot with both eyes closed and count to 15. You'll get a free yogurt if you can, and as you can see from the sign, the stuff ain't cheap. Delicious. But not cheap.

I can explain to you why won’t be able to do this rather difficult task that sounds way more easier than it is, but that would require my medical writer persona who just did a 65 page site on vestibular disorders to come out, and really—wouldn’t it just ruin all the fun we had?

Tuesday, July 20, 2010

Update on the numerals

Yahoo! Style Guide does not change AP Stylebook's judgement on numbers. However, they do say certain language rules are outdated (Old "rules" that no longer apply, pg. 348), including:

• Never split an infinitive
• Never end a sentence with a preposition
• Never start a sentence with a conjunction

I guess we'll have to wait for someone with an ever larger language/style gavel to get rid of writing out numbers 0-9. Maybe that's living on the edge...

Thursday, July 8, 2010

Why you gotta be all AP stylin' on me?



I recognize the need for a style guide. I'm horrified when my clients don't have a basic one, like what they call their institution on second mention within the copy or how they list names (degrees after the name or Dr. X?). But, I have a gripe with the worshipped AP Style guide. A gripe with the numbers thing.

Anyone who's ever read the most basic article on Web writing knows that people/users scan websites for information. If this is true then why are we still writing one for 1, and two for 2, etc. on websites? Doesn't it make sense to use numerals?

Here's the perfect example that I'm writing right now:
(The name of the client has been deleted to protect the innocent, namely me)Blank program has more than 25 board-certified physicians in eight locations throughout Central state....

Why not just say 8 locations? Faster to scan, faster to read, faster to compute. They have 8 locations to serve me. Not eight. 8.

Ok, I'm done ranting. Anyone else behind my desire to get this rule changed? Maybe the Yahoo! style guide will have a different opinion. According to Amazon, I should get my copy today.

And in case you're wondering, that is a picture of The Totally Stylin' Tattoos Barbie.