Web Authoring that Works:
Designing Effective Web Sites and Web Pages

Lesson 4:
Writing for the Web

By Kyle McCaskill, University of Maine Cooperative Extension, and
Leigh Stribling, Auburn University, Alabama Agricultural Experiment Station

In Lesson 4, you will learn how to write effectively for the Web.

To do this, we will consider the following:

To help you improve your site, we will offer:


The effect of Information Overload

Computers (especially e-mail and the Internet) have enabled us to produce a degree of information that is overwhelming. We often feel controlled by it rather than empowered by it.

Because of the proliferation of information,

People are increasingly discriminating about what they'll take the time to read.

Media have responded to information overload by getting progressively louder and flashier in order to be noticed. The result is that people have become desensitized.

Research has shown that Web users do not want to be entertained, they simply want to find information, quickly and easily. Jared Spool commented that it's remarkable "how bad Web sites are in general." His user research found that users were unable to find answers to site-specific content questions on over 50 percent of Web sites tested.1

Don't fall into the trap of using flash or shock value to get noticed. Quality of content attracts and retains users. The only way to stand out now is to stand apart from the din. Give people what they want and no more. Take the responsibility to self-edit. Include only the words and images that are absolutely necessary.

With the technological power to so easily produce information comes the responsibility to practice what David Shenk terms "Information Restraint."2 Only by simplifying, by reducing content to its bare essentials, can we re-value it. 

Return to Top


How the Web differs from print media

Return to Top


How users read on the Web

Return to Top


How page structure can improve usability

Because users can arrive at your pages from a number of unpredictable locations -- search engines, hyperlinks on other sites, hyperlinks on your own pages (remember that the Web is inherently non-linear) -- each Web page should be structured to stand on its own. 

Examples of microcontent include7

Microcontent should be

Guidelines for writing effective microcontent

Headlines should appear at the top of your page and should summarize the content of the page. They can be the same as or similar to your page title. Omit opening articles such as "a" or "the" or vague phrases such as "Welcome to." The first word should carry vital information. Language should be plain and simple. Keep headlines to 60 characters or less. Because online headlines often appear out of context as part of search engine lists, e-mail references or bookmarks, users don't have associated information to help them understand the meaning. Make sure your headlines stand on their own.

NOTE: If your site contains lists of other peoples' pages, you may want to rewrite their headlines, in order to better serve your users.

All subheads on a page should be of approximately equal significance.

In-page indexes (or tables of contents) are useful if your page has more than two content sections or ideas. Use in-page indexes to summarize the page and provide links to every section of the page without scrolling.

An overview (a summary or introduction) is useful when you are presenting a large document with many sections. Provide links within the text, allowing users to choose their own path. Include an in-page index for users who prefer to follow a traditional path through the article.  

Linked text should be explanatory and descriptive so that users know exactly what to expect if they click it. Avoid links that self-reference or reference the Web medium, such as "click here" or "link to home page."  

Effective linking strategies help users find what they are looking for. When creating links, keep the following in mind: 

  • Content links -- links that lead to information -- are more satisfying to users than category links -- links that lead to more links. 
  • Longer, more descriptive  links are better than short links because they help users predict where they will end up.
  • Users prefer shallow sites to sites that are too deep. Practice the "three click rule" -- reduce the number of layers users must navigate through to three.
  • Provide more than one path to each page. Never trap your user in a dead end.
  • Organize content links into easily scannable categories that make sense to your user.
  • Provide a linked author e-mail address on each page to help establish credibility and professionalism.

Bold text helps users scan content quickly for points of interest.

ALT tags should explain the significance of the graphics rather than describe its appearance. Keep ALT tags concise (nine words or less is optimum).

Use captions for photos to eliminate any confusion about what the images are and why you are showing them. 

Special considerations for your home page

Think of your home page as a 30-second radio spot. In that 30 seconds you must tell your audience

Many Web designers treat home pages like magazine covers, designed to attract users to the information inside. However, home pages are inherently different. A magazine cover is designed to persuade a consumer to buy a publication. By the time a user hits your home page, they've already been persuaded to visit your site. The most effective home pages are functional: they tell users how to find what they need on your site. Describe your four or five basic primary services on your home page and organize those choices into scannable, easily understandable lists. 

Return to Top


Effective writing techniques for the Web

Return to Top


Writing effective titles, keywords and summaries

To help users who rely on search engines, include appropriate  titles, keywords, and summaries in the HTML <HEAD> of your pages.

Write concise, descriptive page titles.

A page title is not the same as the page's file name. For example, the file name of this page is "lesson4.htm." The title of this page is "Web Authoring that Works, Lesson 4: Writing for the Web."

Page titles are located in the <HEAD> of a document. The HTML code looks like this:

<HEAD>
<TITLE>Web Authoring that Works, Lesson 4: Writing for the Web</TITLE>
</HEAD>

Page titles show up in search engine query hit lists, in browser "bookmarks" or "favorites" menus, and sometimes in hyperlinks to your pages.

Guidelines for writing effective titles:8

Provide accurate keywords for search engines.

"Keywords" are the terms users type into search engines when initiating a search. In order for search engines to locate and list your information accurately, you should include appropriate keywords on your pages.

Locate your keywords in the <HEAD> of your document, before the <TITLE>. A  keyword META-tag looks like this:

<META name="keywords" content="University of Maine, Cooperative Extension, education, research, agriculture, potato, crop, Verticillium Wilt, fungal disease, tuber">

Guidelines for writing keyword tags:

Provide short, informative summaries for search engines.

Many search engines display summaries below the page title in their query hit list. A one-sentence summary helps users quickly determine if your page matches their interest as they sift through dozens of search results. 

Locate your one-sentence summary in the <HEAD> of your document, before the "keywords" and <TITLE> META-tags. A "description" META-tag looks like this:

<META name="description" content="Verticullium wilt of potatoes is a fungal disease found in Maine crops which can cause yield losses by a reduction in tuber sizes.">

It is good practice to repeat your "description" META-tag as the first sentence on your page.

A one-paragraph summary is an expanded version of the one-sentence summary and is sometimes used by quality search engines. A one-paragraph summary gives users further insight into your information in a few short sentences. Place one-paragraph summaries in the description META-tags of your pages, as in the one-sentence summary example shown above. 

Guidelines for writing effective one-sentence summaries:9

Return to Top


Activities:

1. Take a print document and rewrite it for the Web. Cut the amount of copy by 50 percent. Divide long paragraphs into shorter chunks. Use "microcontent" techniques.

2. Test a document from your Web site for readability. For example, do the title, summary, and major headings provide a very broad overview of the topic? If you skim the highlights (minor points in boldfaced text), do they tell a story? Would a user be able to piece together the bits that are in between, taking away the ideas without all reading every detail?

3. Test your image ALT-tags to determine if they are useful. Imagine reading the alternate text aloud over the telephone. Would your listener understand the meaning of your image description?


Examples of effective Web sites

The New York Times home page is a good example of a page with its headline information located at the top -- the portion of the page most users will see. 

The Information Chronicle includes a good example of an "in-page" index.

CNN's home page is an excellent example of the effective use of micro-content to inform and direct. Note also the inverted pyramid writing style, in which the story is summarized in a chunk that provides a link to the rest of the article.


Accessibility Issues and Solutions:

Consistent page layout, recognizable graphics, and easy-to-understand language benefit all users. In particular, they help users with cognitive disabilities and users who have difficulty reading.

Tips to make your site easier for everyone to read:10

Divide large blocks of information into manageable chunks where natural and appropriate.

Limit each paragraph to one main idea.

Avoid complex sentence structures.

Place distinguishing information at the beginning of headings, paragraphs, lists, etc.

State the topic of the sentence or paragraph at the beginning of the sentence or paragraph. This is called "front-loading." Front-loading will help users who visually scan text, as well as users who rely on speech synthesizers.

Use headings to structure documents; use lists where appropriate.

Strive for clear and accurate headings and link descriptions. This includes using link phrases that are concise and that make sense when read out of context or as part of a series of links (Some users browse by jumping from link to link and read only link text.) Use informative headings so that users can scan a page quickly for information rather than reading it in detail.

Use the clearest and simplest language appropriate for a site's content. Using clear and simple language promotes effective communication. Access to written information can be difficult for people who have cognitive or learning disabilities. Using clear and simple language also benefits people whose first language differs from your own, including those users who communicate primarily in sign language.

Favor words that are commonly used. For example, use "begin" rather than "commence" or use "try" rather than "endeavor."

Use active rather than passive verbs.

Avoid slang, jargon, and specialized meanings of familiar words, unless defined within your document.

Provide text equivalents for every non-text element. Ensure that images have text equivalents for people who are blind, have low vision, or for any user who cannot or has chosen not to view graphics. Text equivalents are also important if your users have older browsers or servers that do not support some HTML features.

Supplement text with graphic or auditory presentations where they will help users understand the page. Providing non-text equivalents -- like pictures, videos, and pre-recorded audio -- of text is also beneficial to some users, especially nonreaders or people who have difficulty reading.

(For more detailed information, visit W3C’s site: Techniques for Web Content Accessibility Guidelines.)

 


Resources:

Return to Top


Footnotes

1http://www.webword.com/interviews/spool.html. Retrieved from the Web 2-12-02.
2See David Shenk, Data Smog: Surviving the Information Glut, (New York: HarperCollins Publishers, 1997).
3How Users Read on the Web, Jacob Nielson
4http://www.webreview.com/1999/07_30/strategists/07_30_99_1.shtml. See also Information Foraging Theory by Xerox PARC researchers Peter Pirolli and Stuart Card, http://www.acm.org/turing/sigs/sigchi/chi95/Electronic/documnts/papers/ppp_bdy.htm. Both retrieved from the Web 2-12-02.
5Web Facts, Sun Microsystems (Jacob Nielson and Jonathan Fox)
6Scannability, Sun Microsystems (Jacob Nielson and Jonathan Fox)
7Microcontent information was largely summarized from Amy Gahran's "In Web Writing, Little Things Mean a Lot," http://websitejournal.netscape.com/O=wsg/interview/041499_microcontent.html, retrieved from the Web 8/28/00.
8Writing to Be Found, Sun Microsystems (Jacob Nielson and Jonathan Fox)
9Ibid.
10Techniques for Web Content Accessibility Guidelines 1.0, W3C

Return to top
Return to the main index.