We have many different users with many different needs. They are novice and expert users, desktop and mobile users, people with visual, hearing, motor, or cognitive impairments, non-native English speakers, and users with different cultural expectations. Following these guidelines will help ensure a better experience for all our users. They will also help us create a more sustainable website.

We have multiple platforms that serve different purposes. It’s important that similar content is co-located, so users can more easily navigate and discover resources. It also makes it easier for us to manage our various kinds of content. 

What Content Goes Where

Focus on creating content that helps our patrons get their work done. Unnecessary content makes it harder for users to find and use our most high-value content. Remember, even pages that are buried deep within the site can still be findable via site search and search engines!

Creating and maintaining high-quality content is time-consuming. Remember that any page you create will need to be maintained regularly so be selective about what you create (don’t create more than you know you’ll be able to properly manage). Also, the more content we have, the harder it is for us to upgrade, redesign, and migrate our website.

• Focus on creating high-value content (geared towards helping users get their work done).
• Avoid creating “just in case” content.
• Focus on content only the library can provide (avoid creating content that can be easily found via the open web).
• The library website is not an archive or filing cabinet. When content is no longer needed or relevant, retire it (unpublish, delete, or archive it in the institutional repository). It may already be available in the Wayback Machine if you ever need to access it again.

Redundant content results in less usable search results, confuses users, and reduces the credibility of the library. Redundant content also creates an unnecessary maintenance burden for us. In particular, unit content should not replicate core content. If a core content page isn’t serving your needs, contact the Web Team to suggest a change.

Tip: search the library website or search Subject Guides to check and see if similar content already exists.

Content should always be accurate, up-to-date, and complete.

• Don’t publish incomplete or placeholder pages.
• Double check that your information is correct.
• Check that all links work and go to the right place.

Consistent, clear, and concise content helps ensure that our website is accessible, understandable, readable, and user-friendly. And remember that we have a diverse audience with varying language skills, knowledge about libraries, technology, etc.

Consistent

Consistent design and language will help our patrons make sense of what the library offers and inconsistencies will slow them down.

• Follow all the content style guide recommendations – but especially use established naming conventions and follow the voice and tone guidelines.

Clear

• Purpose of the page (why it exists) should be crystal clear.
• Content communicates clearly and is easy to understand.
• Follow link recommendations
  • Link labels should be unique and descriptive (they should clearly tell users where they’re going).
  • Email links should show actual email addresses.
• Follow language, voice, and tone recommendations
  • Avoid academic, formal, or complex words when simple ones will do.
  • Avoid unnecessary library jargon.
  • Avoid figurative language.
  • Use plain language.
  • Use acronyms and abbreviations only when necessary.

Tip: if describing a complex process, have a co-worker or student employee who’s unfamiliar with the task try to follow your directions.

Concise

Less is more. Users are often better served by content that is concise as opposed to exhaustively thorough. Being concise does not mean dumbing it down. The faster we can get users to the information they need, the faster they will be able to go on and get their work done. This is especially important for mobile and assistive technology users.

• Keep it simple. According to research by the Nielsen Norman Group, simplicity wins over abundance of choice.
• Avoid preambles and unnecessary descriptions of historical aspects, background information, or highlighting info about internal units. For example, how a service was developed, that something has existed for 12 years, that it’s done in conjunction with an internal department, etc.
• Avoid telling users that you’re going to explain something below, instead, just explain it below (for example, “The following is a brief description about how to…”).
• Use short sentences and short paragraphs.
• Follow language, voice, and tone recommendations
  • Avoid academic, formal, or complex words when simple ones will do.
• Follow lists recommendations
  • Use bulleted lists to group like items together or to simplify lengthy and dense paragraphs.

Structure your page content so patrons can get to the information they need quickly.

• Avoid large blocks of uninterrupted text.
• Put key information at the top of the page (don’t bury the lead).
• Provide a clear “call to action.” If next steps are needed, don’t bury them as links in the middle of a paragraph – separate them out to draw attention to them.
• Follow headings recommendations
  • Use descriptive headings to structure and chunk the contents of your page to enable users to quickly skim.
• Follow lists recommendations
  • Use bulleted lists to group like items together or to simplify lengthy and dense paragraphs.

Tip: a user should be able to find the information they need on your page within a few seconds.

Although your webpage is actually part of a larger set of pages, it will also be accessed out of context when users encounter it via the website search results, Easy Search, and external search engines. In other words, some users may only see your one page.

• Follow page titles recommendations
  • Page titles should be short, specific, descriptive, and in title case.
• Avoid orphaned pages by making sure your page is linked to from another page and that path is clear.
• Use language appropriate for the intended audience (who may be searching to find the content). If you want your content to be findable using their terms, make sure to use language our users use.

In addition to being selective about the content you create, creating future-friendly (aka “evergreen”) content will help ensure your pages stay up-to-date and low-maintenance.

• Avoid duplicating content from an outside and reliable source. For example, just link to GVSU's Information Technology site about wireless instead of creating our own pages that provides the same information.
• Follow language, voice, and tone recommendations
  • Use future-friendly language.
• Follow documents recommendations
  • Be selective about providing content via linked documents.
• Don’t add custom styles or embed non-supported elements that may break over time. If you need something special, contact the Web Team.

Following the above guidelines will be helpful for users with disabilities but in particular, the following will go a long way to ensuring full accessibility.

• • Follow headings recommendations
    • Use descriptive headings to structure and chunk the contents of your page to enable users to quickly skim.
  • Follow links and buttons recommendations
    • Don’t set links to open in a new window.
    • Link labels should be unique and descriptive.
    • Buttons should have action-oriented and descriptive labels.
  • Follow language, voice, and tone recommendations
    • Use inclusive language.
  • Follow images, video, and audio recommendations
    • Use graphics in moderation.
    • Use appropriate image alt text.
    • Videos and audio should provide text-based alternatives.
  • Follow tables recommendations
    • Use tables only for tabular data.
  • Follow documents recommendations
    • Be selective about providing content via linked documents.
  • Colors used on the site were selected in part to ensure proper color contrast so don’t change default text or background colors. If you want to test your color palette for accessibility, try Color Review, a web app that gives you contrast values for any color combination.

Want more? See Accessibility Evaluation for Web Writers and 18F’s Accessibility Guide.