Skip to Main Content

Standards & Styles

Standards for Creating New Guides

Template

The LibGuides administrator has designed a recommended template for new guides using cascading style sheets (CSS) that set the colors, fonts, and other basic styling for University of Delaware Library guides. This helps create a consistent look and feel across the Library web site and research guides.

  • For Course General, Subject, and Topic Guides: Use the UD TEMPLATE - 1 COLUMN template for creating a new guide.

Additional guidelines for creating each of these guide types follow below and in the Guide Layout section of this guide. For step-by-step instructions, visit the Springshare support site page on creating new guides.

Title

Give your guide a title. Titles of academic subject guides should reflect the terminology used in the University's programs of study (e.g., Hospitality Business Management). For course pages/guides, use the course mnemonic and description as your title (e.g., HIST268: Colonialism and Nationalism). To help users narrow down their search for your guide, including the last name of the course faculty member (in parenthesis) is also a recommended best practice: e.g., ENGL110: Freedom Riders (Bannowsky). This information is provided in the University's Course Descriptions database. 

Type/Group

Choose the appropriate guide type for the guide you are creating:

  • All guides should be labeled as "General Purpose."
  • Internal: Guides that are only to be shared with Library, Museums and Press Staff

Group Assignment: 

  • Choose the appropriate Group for which category you need the guide to appear in (i.e. Collections, Library DIY, or Subject)

Friendly URL

Giving your guide a friendly URL makes sharing and remembering its location much easier.  For example, this guide uses a friendly URL (https://guides.lib.udel.edu/training) instead of the URL created by the LibGuides system (https://guides.lib.udel.edu/content.php?pid=123456). Best practices for constructing friendly URLs include:

  • Use lowercase lettering.
  • Don't use underscores, ampersands, or spaces.
  • For subject and topic guides, use brief versions of their subjects:
    • /sociology
    • /latiinamericanlit
  • For guides created for specific classes, use the include the course number (with section number, if needed to differentiate between guides):
    • /posc328
    • /engl110-010

Subjects

Assign one relevant subject from the existing list to your guide based on the available subject categories. DO NOT ASSIGN A SUBJECT TO A COURSE GUIDE!!!

Tags

Like subjects, tags help users find your guides when they search all of the Library's guides using keywords. This is not as important of a practice as it used to be, so tags are not necessary. Although not recommend, you are still welcome to add tags to your guide. If you choose to, you should use three to six tags for each guide. Paradoxically, adding too many tags can make searching less effective. Use tags from the existing list whenever possible.

For course guides, use "course page," the instructor's last name, and the course mnemonic as tags. If a course is cross-listed, provide both mnemonics. For example, if "ANTH216: Introduction to Material Culture Studies" is taught by De Cunzo and is cross-listed as HIST216, the tags could be: anthropology, class page, De Cunzo, ANTH216, HIST216.

Description (Optional)

Use this optional field to describe the scope of a guide if it is not evident from the guide title. The text of the description is searchable, and the text is displayed at the top of the guide.