Skip to Main Content
Chat With Us

LibGuides Standards and Best Practices

:

Getting Started

Best Practices for Research and Course Guides

Creating a well designed Guide

This guide will help you create a usable, readable and well designed guide for Boston College. It lists standards, best practices, and guidelines to follow when creating and updating guides or webpages.

Writing for the Web

Users will skim and select content on web pages in an F-shaped pattern. Make your guide content easy to read with these tips:

  • Write clearly and simply.
  • Put the most important information at the top.
  • Avoid long paragraphs of content. Use lists.
  • Less is more! Aim for action content and avoid prose. 
  • Break up long lists. Lists with more than 7 items appear long and may not get read.
  • Link to denser material deeper in the page.

Tone

  • Use a personal tone in writing.
  • Focus on using an active voice rather than passive.
    • active voice: The library provides study spaces.
    • passive voice: Study Spaces are provided at the library.
  • Use pronouns. The user is You. The library is We.
    • "We provide study spaces."
    • "We'll help you find the most relevant resources."
  • Avoid jargon. Use words the user will use.
    • Bad: "The link resolver will direct you to intermediary pages with direct links to publisher and vendor-provided sites with pdf or html versions of articles."
    • Good: "Click 'FindIt' to get full-text articles."

LibGuides or Guides or Web Pages?

"LibGuides" refers only to the web-based software package by SpringShare. The consensus at BC Libraries is that the general term "guides" is a category that refers to librarian-created web pages that are aids for subject- or course-based research; in this category there are "subject guides,", "course guides," "portal pages," and "how-to guides." The rest of the site is composed simply of web pages.

It is important internally that we don't confuse LibGuides (the package) with the pages created with that package, and important in communicating with library patrons that "LibGuides" not be used at all. (Think of "LibGuides" as being akin to "Microsoft Word." You would never refer to a document created in MS Word this way: "Just read that MS Word I sent you.")

Are they called Tabs or Pages?

For consistency's sake, call them pages. SpringShare calls them pages and so do users.

Additional Resources

The following Boston College sites provide introductory information on LibGuides and basic editorial guidelines.

 

The following sites contain resources for effective usablity and writing for the web.

 

The following are a small survey of University best-practice guides.

Guide Author

Profile Photo
Jesse Martinez
he/him/his
Contact:
O'Neill Library 503
Boston College
617-552-2509
Website