.

Astrolabe Websites and eSolutions
www.astrolabewebsites.ca
RR1
Burnstown ON K0J 1G0

613.432.9669

lynn@astrolabewebsites.ca

3/28/2012

Adopting a specialized writing style for the web is important for reasons such as readability, search engine optimization and accessibility. Fortunately, there is a great deal of overlap in the strategies for writing for these factors.  A tactic that improves readability of text on the web may also improve accessibility or make your web pages more search engine friendly. This guide offers some practical suggestions for crafting your articles and text for website publication and outlines editorial styles.

© Lynn Villeneuve  All rights reserved





Table of Contents

Writing for the Web

Writing for Search Engine Optimization (SEO)

Writing for accessibility




Writing for the Web

Introduction

Adopting a specialized writing style for the web is important for several reasons.

  1. People read differently on the Web
  2. How you write or use words can increase or decrease accessibility for people with disabilities
  3. The words you use and where you use them can influence how well search engines find your website.

Fortunately, there is a great deal of overlap in the strategies for writing for the above factors.  A tactic that improves readability of text on the web may also improve accessibility or make your web pages more search engine friendly.

This guide offers some practical suggestions for crafting your articles and text for website publication as well as outlines editorial styles for the web.

People read differently on the Web

The web is not linear. People may enter a site from any page other than the home page and roam from page to page in no particular order. Web pages need to be more independent than print pages for this reason. Each page must stand alone, even if it follows from or relates to another page. This means that you may need to briefly repeat information found on another page if it’s relevant to the reader’s understanding of the content on the current page (much like a synopsis of the previous week’s show provides context for a new episode of a TV drama or soap opera).

People tend to skim web pages rather than read them word-by-word. As a result, a writing genre characterized by clear, concise text in short segments with ample editorial landmarks (titles, headings, etc.) has developed specifically for the web. Even methodical readers benefit when you accommodate online reading patterns!

Writing style for the Web

Write to empower not to impress. Aim for a style that is credible and accurate but not overtly scholarly.

At all times, maintain a high editorial standard.

top

Writing the content for your website

Write as simply and clearly as possible. Be frugal with text. Make sure it has value to the reader. Concise text is always better but you should not “dumb down” your writing.

People don’t read web pages they scan or skim. The more scanable your content is, the better.

Use descriptive headings and sub-headings (H1, H2, H3, and H4 - as found in Microsoft Word)

Recommended text styles

Headline style: Bold, capitalize first letters of words

Down style: bold, capitalize first word only

top

Links

Use thoughtful hypertext links to reinforce your message, not to distract the reader. Most links should point to resources within the site. Should you send the reader elsewhere, the link should make it clear that the reader will be leaving for another domain.

The key to good hypertext linking is to maintain context so that the reader stays within the narrative flow.

Page titles (as appear at the top of browser windows)

Each web page should have a customized title relating to the pertinent theme on that page. A page title has several functions beyond providing a clue about the nature of the content on that page so it’s important to make your page titles as meaningful as possible.

  1. The page title is the first thing users with slow Internet connections will see (yes, there are still slow Internet connections!). The page title may determine if the user will wait long enough to view the downloaded page
  2.  It becomes the text in bookmarks or favourites that users create. It will remind the user about what’s on the page — what he or she found to be of interest.
  3. Page titles are important for search engine optimization. Search engines regard page titles as the primary description of page content. A good descriptive page title using well-chosen keywords increases the chance that a page will appear as the result of a related search query.

Page titles should:

  1. Incorporate the name of the organization or website
  2. Form a concise plainly-worded reminder of the page contents
  3. Have a maximum of 90 characters.

International date format

When inserting dates into text, use the international date format: day/month/year.

top

Use of keywords

Learn more detailed information about keywords and their role in search engine optimization.

Meta description

A Meta description is a short concise summary of the content of a web page that is placed in the HTML code of each web page. It appears on search engine results pages and may be the deciding factor in whether a user visits the page. Keep it brief, informative and interesting enough to tempt website users to go to the page. Aim for 25 to 30 words including keywords and or key phrases. Provide this list to the web developer for inputting into the page “code”.

Glossary definitions

You may have included words/terms within the text for which there should be a definition placed in the website’s glossary. Each writer should provide a list of those terms with an original definition (i.e. not plagiarized) or properly annotated definition for each.

Graphics

Use images judiciously to enhance content. Make certain that each photo, illustration or other type of graphic serves a clear purpose and makes a contribution to the page content and the site.

  1. Suggest a selection of several images to illustrate written content if appropriate. For each, include the following:
    • The source of the image (where the image can be found)
    • Copyright/credit information
    • An appropriate caption
    • A short alternate text (commonly referred to as alt text). This is a brief description of the image or illustration that is placed in the webpage code and is an important aspect of accessibility, especially for blind or low vision people who use assistive devices such as screen readers.

Writing for Search Engine Optimization (SEO)

Susan Ward of About.com’s Small Business: Canada puts search engine optimization in very simple terms. According to Susan, search engine optimization is the “art and science of making web pages attractive to the search engines.” SEO is all about placement (ranking) in search engine results. Since 2000, the Internet has grown rapidly.  Estimates vary, but some sources indicate that Google may index over 20 billion web pages. As a result SEO has also grown exponentially and has become an industry in itself. SEO is not necessarily difficult but it does involve acquiring specific knowledge and being willing to spend time working on SEO on a regular basis. Short of hiring SEO specialists, which may prove expensive, there are many strategies and actions you can take on your own to improve the ranking of your website. In this document, I refer only to those actions relating to how the written word can be used in website content and code to make your site more search engine friendly.

top

Content is king

Search engines don’t rank websites. They rank the popularity of individual pages and the relevance of content. The first step in achieving good search engine results is providing good, relevant content and links within pages.

Each page of your website needs to be optimized for search and must be well linked to other pages within your website. Inbound links from other sites, especially popular websites, are crucial. You may wish to develop a strategy for obtaining such links. It’s also not enough to write and upload your website content once. You need to update existing content and provide new content on an ongoing basis.

Keywords rule

Before you start writing content for a new website or revising content on an existing website, you need to develop a list of keywords that you know or think that people use to search for your website. Keywords may be a single word or a phrase. Specific keywords are usually better than general ones. For example “dentists in Ottawa” may be better than “dentists.” Singular and plural forms of a word represent different keywords — for example dentist and dentists. If you are using an analytics program, such as Google Analytics, you will be able to track the keywords used by searching for your website. In addition, Google also offers a tool that will show you what keywords have been used on similar websites or topic areas.

Once you have your keywords, how you use them is important. In descending order of hierarchy, use your keywords as follow on each page.

  1. In the page title of each page (located in the HTML code)
  2. In major headings in the content of each page (coded as h1, h2, h3, h4 and similar to the heading available in Microsoft Word). H1 carries more weight than h2 which carries more weight than h3, etc.
  3. In the first several paragraphs of text on a web page and, where possible, in the beginning of sentences.
  4. In the text of links to other pages in the website.
  5. In the Alt text (or alternative text) for images, illustrations, charts, etc. used on a webpage. Alt text is a short description of what is in each image or graphic and is placed in the code of web pages.
  6. In the HTML file name for each page and directory (folder or sub-folder) of a website. It’s ‘best practice” to use hyphens to separate words within a file name. For example, growing-roses-in-Canada.html is better than growingrosesincanada.html or growing_roses_in_canada.html.
  7. In organized Meta tags, particularly the Meta keywords tag and the Meta description tag which go in the coding of web pages.

top

Writing for accessibility

Accessibility means “making allowances for the characteristics a person cannot change at all or change easily”. While most people will never know the differences between accessible and non accessible websites, disabled users with such disabilities as follow will:

In Ontario, the Accessibility for Ontarians with Disabilities Act now requires that all communication with clients be accessible. It requires that content on websites also be accessible. As with search engine optimization, there are many strategies for making websites accessible. This document only deals with the ways words and text may be written to improve accessibility.  Most of the following suggestions have appeared previously in this document since they also serve to improve readability and searchability.

top