Archive for category Web Content Series

Web Content Series: Write Descriptive Links

Your content is concise and scannable, and now you want to add value to the reader experience. You can do this by using links to help readers find content related to the topic.  Links are maps to information, and must be clear and concise so that readers arrive at the correct destination.The following guidelines can help ensure that links describe exactly what the reader wants.

  • Use the title as the link.
  • Don’t use a long URL in the title or description. In fact, I suggest not using a URL at all, but if you must, try free services like bitly.com to shorten URL links. When using shortened URLs, consider the possibility of link rot, that they could be blocked or misconstrued as spam or questionable content, and other issues.
  • Avoid phrases like “click here,” “here,” and “more info.”
  • Four words or less ensures that links are easy to scan.
  • Provide links to resources and related information; don’t summarize.
  • Provide cross-references.
  • Use key words—what people search for—to improve scannability as well as the chances of your content ranking higher in search engines.

Is it possible to describe a destination in four words or less? When is it better to link to the URL?

Copyright 2012 by Lisa Hodson

Previously on Web Content Series

Web Content Series: Make Content Scannable, 13 Apr 2012 

Web Content Series: Organize Your Content, 20 Apr 2012

______________________________________________

Resources: Microsoft Manual of Style, 4th Edition.

Is it possible to describe a destination in four words or less? When is it better to link to the URL?

, , , ,

6 Comments

Web Content Series: Organize Your Content

In my early years as a technical writer, the most common approach for developing documentation was to tell readers what you were going to tell them, tell them what you want them to know, and then tell them what you just told them. This approach produced content-rich information that end users and readers had to sift through before they found what they needed, which was usually how to perform a task or procedure. Readers don’t make time for much these days—deadlines loom, multi-tasking is the norm—and frankly, neither do I. Getting to the point benefits both the readers and me by improving usability and decreasing time to market. The following guidelines can help you get to the point quickly without sacrificing quality.

  • Put the most important content first using key words in the headings, subheadings, and the first sentence of each paragraph.
  • Give readers the who, what, when, where, and why in the first sentence or two, or paragraph.
  • Communicate in plain language and use short paragraphs that focus on a small chunk of information.
  • Provide links to related information. (Don’t over do it.)

In my post, Carl Albert Public Internship Program: Real Experience, Lifetime Connections, the most important content is in the heading and the first paragraph, as well as in a link to the CAPIP web page.

Carl Albert Public Internship Program: Real Experience, Lifetime Connections

Interested in public service? Want to build a network of professionals in your area of interest while getting paid? Consider becoming a Carl Albert Public Intern or an Executive Fellow. The Carl Albert Public Internship Program (CAPIP)  is open to undergraduate and graduate students currently enrolled in an accredited university. This Program is ongoing; hence, there is no application deadline.

There’s much more to the post, but the basic key points, or takeaways—name of the internship, network, get paid, and no application deadline—ensure that if readers don’t read further, they have what they need. A link to the source is also included and serves as a visual cue that tells the reader, “Hey! Click me to learn more.”

It’s not about you or me; it’s about the readers’ experience. Getting to the point in your content gives readers what they want without sacrificing quality, and they are more likely to visit again.

Previously on Web Content Series

Web Content Series: Make Content Scannable, 20 Apr 2012 

______________________________________________

Resources: Microsoft Manual of Style, 4th Edition.

How do you organize your content for ease of use? 

, , , , , , , , , ,

1 Comment

Web Content Series: Make content scannable

Readers scan online content—titles, headings, paragraphs, links—and decide quickly if content is meaningful to them. When they find what they need, they’ll continue reading. The following guidelines can help you write and deliver content that the reader needs, right when they need it.

  • Use keywords in headings and subheadings
  • Provide links in the Table of Contents
  • Create lists in bullet format
  • Write content in concise, short paragraphs, or chunks
  • Include adequate white space between chunks of information
  • Place the most important content at the top of the web page or on the first screen
  • Eliminate the need for the user to scroll through content by reducing word count or dividing content into separate topics on individual pages

More in this series

Web Content Series: Organize Your Content, 23 April 2012

Web Content Series: Write Descriptive Links, 27 April 2012

_____________________________________________

Resources: Microsoft Manual of Style, 4th Edition.

What other strategies do you use to make text scannable?

, , , ,

Leave a comment