Content & Style Guide: Style Guidelines as of June 2022

Includes link to Tutorials Guide
https://infoguides.rit.edu/prf.php?id=58a0f70c-7cdb-11ed-9922-0ad758b798c3

RIT LibGuides Style Guidelines (Updated September 2022)

 

Purpose of LibGuides

  • RIT's LibGuides site is called InfoGuides and consists of the main InfoGuides site at infoguides.rit.edu which is curated by the RIS department for classes taught at RIT in Rochester and online, and the Global Campus groups which serve the international campuses. There is also a Library Services group for policy and procedure information. Most of the info on the former Library Services group has been moved the main library website with the most recent redesign of the library site.
  • Through course, subject and general help guides, InfoGuides provides library patrons with context and links to useful resources curated by the reference librarians to support classes and subjects taught at RIT.

Guide Types

  • Guide Types are assigned within the InfoGuides system.
  • Make sure to assign your guide the Subject or Course Guide Type when publishing the guide.
  • The third type, General Help Guide, is reserved for broad help guides related to library research or services supporting research. These guides must be approved. Make a request to the InfoGuides Administrator before starting a General Help Guide.
  • Topic Guides are not used on our system. Do not assign this Type.
  • Internal Guide designations are available but not recommended to share internal information. Use the wiki at wiki.rit.edu to share internal information.
  • Template Guides are available and should be used to replicate guide designs. If you create a template please keep within our basic design of side tab navigation, no profile boxes.

InfoGuides Guide Types:

  • Course Guide
  • Subject Guide
  • General Help Guides

Course Guide Definition

Course Guides contain unique information resources for a specific course (a course might have multiple sections requiring separate course guides depending on the unique nature of assignments across sections).

A Course Guide would be created when unique information for course projects would not be appropriate for a Subject Guide.

Course Guide Title Course Guide titles should begin with Course Number. No sections numbers. If there is a need for a course guide for multiple sections add the professors last name to Course Guide Title. Name should match SIS. Example HIST 101 Making History or if multiple sections due to unique assignments HIST 101 Making History Smith

Subject Guide Definition

Subject Guides contain information and resources helpful for multiple courses under a subject taught at RIT. It is helpful to have subject guides reflect the subject names of degrees or departments but librarians can use their discretion and knowledge of language used in their colleges.

General Help Guides

General Help Guides contain broad information and resources related to library research or services supporting research. 

These guides reflect information literacy and pedagogy based topics.

Global Campuses Groups

The Global Campus groups are geographic in nature. These groups are for the international campuses only. As of July 2021 there are 4 Global Campus InfoGuides Groups: RIT Dubai, RIT Croatia, RIT Kosovo, and  RIT China.

 

Library Services Group (RETIRED End of 2022)

RETIRED End of 2022

The Library Services groups at https://infoguides.rit.edu/services contains information related to non-information literacy/pedagogy and non-subject/course based topics.

These guides contain policy and process guides and should not duplicate information already on the library website.

As of July 2021 this group is down to one guide related to Alumni. All other content was moved the main library website at library.rit.edu

July 2022 the last guide, RIT Alumni has been made private and redirected to https://www.rit.edu/library/rit-alumni

Guide Page Layout:

  • To create a consistent user experience build guides using the specific template provided for you. This template will be called [Your First Name] Template.
  • Guide descriptions are optional in the Guide Description field. These can be used to clarify the focus of guide. Example: “This guide will help you find marketing resources to help you create a marketing or business plan.” They should be more than just a reiteration of the Guide title. Consider including a learning outcome.
  • Consider, but not required, using Learning prompts such as:
    • Where to get started…
    • How to get started…
    • Start with…
    • Keep in mind…
  • Tabs aka Pages are placed on the left side in our system.
  • Tabs names could be media type (books, articles, databases) or conceptual (demographics, industry information). This choice is based on the librarian’s knowledge of the information, research needs, audience.
  • Number of tabs is not limited but should not overwhelm the user. Eight or less is recommended.
  • Every Guide has a Chat/Email/Appointments button already programmed in to provide a chat box, LibCal Appointment button, and contact information of the guide owner.

Profile Box

  • Our system does not use out of the box profile boxes.
  • The system is custom coded to display a Chat/Email/Appointments button on every guide and the homepages. This button initiates a modal with either Reference Desk contact info or Librarian specific contact info depending on who owns the guide.
  • Each modal contains librarian photo, Email address, Meet with [Librarian Name] Schedule Appointment button to launch LibCal modal, Call [Librarian] info with phone number, Reference Desk phone number and link to business hours page, and Chat box.
  • Information in the Modal is drawn from the LibApps profile section.
  • Do not display librarian profile boxes are on the guides. Instead the last tab on each guide can link to a profile page if so desired to give more information than is available via the Chat/Email/Appointments button on each guide to the top right.
  • In unique situations multiple profile boxes can be added to a page. For example multiple librarians are working with a class. Beware that chat code sometimes does not work when two profile boxes are displayed on one page. If this happens use tabs linking to profile pages.

Naming Tabs

 

 

  • Tabs name should concise with the fewest words possible.
  • Tabs names could be media type (books, articles, databases) or conceptual (demographics, industry information). This choice is based on the librarian’s knowledge of the information, research needs, and audience.

Page Contents

  • Scrolling should be limited as much as possible whenever possible.
  • Try not to overwhelm users with too much information. Strive for a combination of usability and guidance.
  • Try viewing your guide on a mobile device to see if there is too much on one page for a smaller screen.

Descriptions of Items

  • Descriptions of items should be brief and focused on why the item is useful. Provide a context to the item for the user instead of a basic description. What outcomes could this resource help achieve?

Box Descriptions

  • Be concise and factual.

Database Links

  • Use the database links from the LibGuides Database A-Z list found under Assets. This list mirrors the library website database list. Using the internal LibGuides list will track database usage from LibGuides. You can make your own personal Lockerbox with links to the LibGuides A-Z Databases if this helps your workflow. This will still track statistics for hits to the database.

Rich Text Boxes (RTB)

  • Rich Text Boxes Are used to convey contextual information.
  • Starting September 2022 DO NOT use hyperlinks/URLs within the Rich Text Box. When you need to offer context with a link, use the Link Asset before or after the RTB. 

Book Links & Covers

  • Limit linking to single book titles.
  • Consider the special reason a book needs to be highlighted in LibGuides vs. providing a dynamic, self-updating link to a search in the catalog. Maintaining multiple book titles in LibGuides over time is labor intensive and may lead to stale information.
  • Linking to books in ebook packages instead of linking to the catalog record may cause future labor if the vendor changes the direct links or the ebook package is cancelled.
  • It makes sense to link to a single book when that book(s) is assigned in a course.
  • It makes sense to link to a catalog search when trying to direct patrons to books on a subject.
  • When linking to books through the single title Books from Catalog box use Syndetics.
  • Do not link to Amazon book covers, because this redirects the user away from the source they are looking for and could imply that they should buy a copy.

Images

  • Images and illustrations should be used in a way that contributes to the purpose and content of the guide.
  • Images and illustrations must be used according to copyright standards with an attribution at the bottom of the photo or illustration. 
  • Try to only use images you own the copyright to or images RIT owns and has made available for staff use publicly. If you use images from other sources verify the copyright allows you to use the image.
  • When using images upload them into the Image Manager. Do not link to images on the web using code.
  • As of March 2019 Springshare has said it has added image attribution to their list of desired enhancements. If this becomes a part of the product we should switch to that tool for attribution.
  • Add alt text to all images.

Videos

  • Videos should contribute to the purpose of the guides.
  • Videos should be short.
  • Videos must be used according to copyright standards.
  • Videos should demonstrate how to use a resource or explain a research concept.
  • Videos made by the library must be captioned if they contain audio. Videos reused from elsewhere should be captioned.
  • If a video does not contain audio, the description or text on the video should state that it does not have audio.
  • Ensure copyright for videos reused from elsewhere allow for your use.

***General Lockerbox*** NO LONGER USED but may have items linked on older guides (this houses items that explain general concepts such as scholarly vs. non-scholarly articles, citation, information literacy related topics etc.)

  • As of Nov 2019 this guide still exists but is no longer updated. Items on this page are most likely out of date. Creators should be creating an asset first and then linking to that asset.

Tags

  • The tags are not made public on the site and are used only to connect with myCourses.
  • Tags should be Course Subject Codes and Course Numbers only to allow InfoGuides content to be linked to myCourses.
  • Do not use descriptive words.
  • Tag both subject and course guides.
  • Subject guides should be tagged with the 4 letter Course Subject Code. For example acct
  • Course guides should get the Course Number without the section number. For example maat307
  • Course guides with same course number should be differentiated using the section code. No two guides should have the same tag.

Easy URL

  • All guides should have an easy URL assigned for ease of linking in myCourses and for sending links to students.
  • For course guides use course number for Easy URL.
  • Pages can also have easy URLs.

Subject Headings

  • Each subject heading is assigned to a librarian. Be mindful of using subject headings assigned to other librarians. Let others know you want to use a subject heading not assigned to you before assigning the subject heading.
  • Assignees:
    • Academic Integrity and Citation = Reference Desk
    • Art & Design = Claire
    • Business = Jennifer
    • Computing = TBD 2022
    • Deaf Studies = Joan
    • Engineering and Applied Science = Roman
    • Humanities and Social Sciences = Cami Goldowitz
    • LIV@RIT = Reference Desk
    • Mathematics, Sciences and Health Sciences = Adwoa
    • SOIS = Ryan

Originally adapted with permission from Coastal Carolina University LibGuides Standards

Edit this Guide

Log into Dashboard

Use of RIT resources is reserved for current RIT students, faculty and staff for academic and teaching purposes only.
Please contact your librarian with any questions.

Facebook icon  Twitter icon  Instagram icon  YouTube icon