Skip to content

This guide provides instructions and information about Stanford Web Services Jumpstart platform, based on Drupal 7.

We've released our new Stanford Sites on Drupal 8 (D8) platform — the new framework for Stanford Sites in 2020 and beyond. Check out our new User Guide to help you set up your website on the D8 platform. 

Read more about our road to D8 

Accessible Content Tips

Well-structured content follows basic formatting guidelines that ensure that your website is well-organized, clearly understandable to readers, and accessible to people with disabilities.

Such guidelines provide the added benefit of making your site more findable and promotable, since Google and other search engines "see" pages that are well-formatted better than those that aren't. Creating well-structured content requires the usage of some basic patterns and strategies.

Headings and Page Titles

Headings are HTML tags that are used to divide sections of a page. The number in each heading indicates its level in the content’s hierarchy. By default, your page titles will be formatted as a Heading 1.

  • Heading 1: Page title
  • Heading 2: Sub head (added in content)
  • Heading 3: Grouping or title within Sub-head (added in content)
  • Heading 4: Grouping or title within grouping (added in content)

Basic Patterns and Strategies:

  • Keep it short: skip unneeded words like “How do I...” or “Read how to...”
  • But not too short: include keywords to ensure people will understand the context of this page.
  • Keep it simple: avoid jargon and technical terms if possible.
  • Use sentence case for readability. (Page titles can be in title case if desired.)
  • Ensure all page titles in your site are unique.

Read more: https://swsblog.stanford.edu/blog/writing-web-2-titles-and-headings

Structured Content: Paragraphs and Lists

Basic Patterns and Strategies:

  • Keep it short: cut out all superfluous text and words
  • Write your content in small chunks and mini-paragraphs: avoid the “Wall of Text”
  • Use HTML bulleted or numbered lists for steps in a task and item lists

Read more: https://swsblog.stanford.edu/blog/writing-web-5-paragraphs
Read more: https://swsblog.stanford.edu/blog/writing-web-4-lists

Calls to Action and Links

Links are used to guide people through your website or to content hosted elsewhere, and encourage your users to take specific actions.

Basic Patterns and Strategies:

  • Give a little detail: Avoid making link text too short. “Read more” or “Click Here” can cause accessibility problems.
  • Start with a verb: The most important part of a Call to Action is the leading verb. People are far less likely to click on a link that is a noun, they want to be led through your site. Rather than “About Us,” try “Read about our team.”

Read more: https://swsblog.stanford.edu/blog/writing-web-1-calls-action

Tables

Only use tables for communicating tabular data (like charts of statistics), not for page layout.

Special Considerations:

  • Tables are not currently mobile responsive, so they will be awkward in tablet and mobile browsing

Read more: https://swsblog.stanford.edu/blog/writing-web-6-freeing-your-content-html-tables-used-layout

Check your Content

A simple way you can check the accessibility on your page is by using the Web Accessibility Evaluation Tool at https://wave.webaim.org/ and pasting your URL into the Web page address... field.
 
If you find yourself repeatedly checking accessibility, you may want to install the WAVE extension. It's available for both Chrome and Firefox browsers at https://wave.webaim.org/extension/.
 
For more comprehensive accessibility testing, you may want to consider using services from Level Access. You can learn more at: https://soap.stanford.edu/make-accessible.

Resources

Here are some resources for Stanford web designers, developers, and content creators that can be used as guides for producing materials which are accessible to the broadest audience possible.

Stanford Online Accessibility Program
SWS Blog: Writing for the Web
Writing Good Content