Waterloo LibGuides for guide authors: Maintaining Your Guide

Before each semester

1. Check links using the link checker.
2. Review our guide checklist.
3. If you have altered your guide extensively, ask a colleague to proofread it.

During the semester

1. Keep track of whether your guide is published, private, or unpublished.
2. Make note of any updates and changes needed.
3. Hide pages and/or boxes if information is no longer relevant or accurate. 

This checklist will be updated as best practices change. 

General

• Guide type has been assigned correctly.
• The Guide has a "Get started" page.
• Profile information is updated.
• The purpose of the guide is stated on the "Get started" page.
• Subjects and tags have been assigned.
• The guide has no more than five pages.
  • If more tabs are needed, consider creating a course or topic guide instead. 
• Links are added as links, not rich text.
• Databases are added as databases, not rich text.
• Images, audio, and video are either public domain or comply with copyright requirements.
• Image files have been resized.

Accessibility

• The guide and its pages all have friendly URLs.
• No tabbed boxes are used.
• Clear and descriptive headings are used to aid navigation.
• Links are easily understood out of context.
• URLs are replaced with links.
• Links open in the same tab or window unless absolutely necessary. If absolutely necessary, they should indicate that they will open in a new tab or window. 
• Tables are simple.
• Tables are clearly organized (labels for columns and rows, coding for empty cells). 
• Captions and descriptions are provided for tables. 
• Tables are only used for data.
• Information can be perceived by all users.
  • Images have relevant alt-text. 
  • Transcripts for audio and video are provided.
  • Any attached or embedded materials are provided in accessible formats. 
• Text is unformatted (no bold, underlining, italics, font changes, etc.), except through the "format" dropdown menu.
• Consistency is seen throughout the Guide.
• Online accessibility tools have been used to check for potential barriers.

The Link Checker allows you to quickly find and fix any broken links in all of the LibGuides you own. To use it:

1. Go to the LibGuides page in LibApps.
2. Click on the "Tools" dropdown menu.
3. Select "Link checker."
4. Type your name into the "owner" field in the following format "Last Name, First Name" to filter to guides you own.
5. A list of broken links on your LibGuides will be displayed.
6. Select the pen icon in the "asset" column of the table to edit.
7. Update and save.