Usability and Style Guidelines

Writing for the Web:

1. Help the reader skim by using headings, subheadings, and summaries. Use short paragraphs, scannable layout, and bulleted lists.

2. Use the benefits to entice visitors to learn more. When they go deeper into the site, start selling the features. (Writing Good Web Page Content)

3. Instead of creating a list that reads:
We meet all your ____ needs by:

Create a list that reads like this:
At ABC Company, we offer you:

Link text

1. Don't use "click here" as link text. Instead of "To download W3C's editor/browser Amaya, click here", use "Get Amaya". Meaningful anchor text helps users understand what they will get when they click the link, and also helps the user scan and quickly differentiate between links.

2. Don't put verb phrases in link text. Instead of "Tell me more about Amaya", use "Tell me more about Amaya: W3C's free editor/browser that lets you create HTML, SVG, and MathML documents."

3. When writing copy, write about your subject; even if the text contains links. (Writing hypertext copy)

Elf Sternberg is known as the author of the Journal Entries, an epical work of serialized erotic fiction.
Do not write about the reader's movements, neither in terms of changing servers or visiting resources:
Go to the home page of Elf Sternberg.
nor in terms of interactions with their user interface:

Click here to visit Elf Sternberg's home page.

4. Avoid talking about mechanics. For example, "Our archive includes much public domain software and text whose copyright has expired." instead of "There is now WWW access to our large FTP archive which was previously only available by FTP, NFS and mail. This collection includes much public domain software and text whose copyright has expired."

As another example, use "The tutorial has more about this." instead of "You can read more about this in the tutorial which is linked to the home page "

5. Write links that don't have to be followed. Providing summary information at the link site can convey enough information to save the reader from following links they would otherwise have to follow just to find out a small amount of information. For example, "Our conclusion is that the stock is up because of an unusually high beta, not because of earnings growth."

6. When providing a list of links or other resources, do not include the words “homepage” or “website”. Of course it’s a website, and the user will assume that it is the homepage unless notified otherwise.

Other usability guidelines:

10 Commandments for Great Copywriting

From Writing Compelling Promotional Copy

  1. Know Your Audience
  2. Determine Your Value Proposition
  3. Find a Unique Selling Proposition (USP)
  4. Establish an Objective
  5. Use a Compelling Subject Line
  6. Include a Great Headline
  7. Avoid Weasel Words
  8. Don't Use Passive Voice - Write in the Present!
  9. Include a Customer Quote
  10. Keep Copy Clean and Concise

Other Links