HSLIC LibGuides Style Guide

• Think about who the user of the guide is. What do they need and why? It can be tempting to start building guides to just house resources, but we need to be purposeful in building instructional tools.
  • You might be creating a guide for a specific department geared towards faculty and researchers one day and a subject guide for undergraduate students getting started with literature searching another day. It is okay to adapt the way you structure guides and how much instructional content you provide based on this. While we do want some standardization of design and tone across all guides, that is not to limit you from adapting the guides you create to suit the needs of your audience.
• Write content from a user-centered approach, avoiding library jargon, and communicate messages as briefly as possible.

• The first word in the headline
• Verbs, even if they’re short (e.g., Be, Is, Are)
• Conjunctions and prepositions that contain five or more letters (e.g., About, Around, Beside, Through, Toward, Under)
• All other words (e.g., nouns, pronouns, adverbs, adjectives)

• Articles (e.g., a, an, the), conjunctions (e.g., and, but, for, or, nor, yet, so) and prepositions that contain four or fewer letters (e.g., by, for, in, of, on, to, with)
• For example: Board Is Under No Obligation to Disclose Source, Lawyer Says

• Make sure to capitalize "The" if a title in includes it.
• For example, "The New York Times" or "The Albuquerque Journal"

• Use only one space, not two, after periods and other punctuation. 

• Place commas and periods inside (before) ending quotation marks, not outside (after) them.
  • For example: Be sure to visit the Maxwell Museum's exhibit, "People of the Southwest."
• Use a serial comma.
  • For example: The purpose of this document is to create a vision based on agreed commonalities, strengths, and goals.
• Insert a comma after introductory clauses.
  • In the pages of this report, we shine a light on our second year of this plan.
• Use a comma in a compound sentence (a sentence that contains two independent clauses joined by a coordinator such as "and," "but," "for," etc.
  • In the pages of this report, we shine alight on the second year of the plan.

Dashes & Hyphens

• Use an em dash (—), not a hyphen or hyphens, to indicate a break in thought.
• Use an en dash (–), not a hyphen, to indicate a range of dates, times, etc. Do not place a space on either side of the em dash or en dash.
  • For example: UNM’s cast performed the play—Disney’s Beauty and the Beast—July 9–11, 2009.

Ampersand

• Use the ampersand (&) instead of spelling out "and" in guide, page, or box titles
• Don't use the ampersand (&) in the body of the text unless you are referring to the title

• HSC not "the HSC"
• HSLIC not "the HSLIC"

• Database titles should be capitalized.
• Titles of books, magazines, journals and films/movies should be capitalized.
• Avoid using the underline feature, hyperlinks will automatically include appropriate formatting.

• Do not type out actual email addresses, instead use non-scrape-able text like “email us” or whatever and add the email hyperlink to that content.
  • Note: Unless there is a specific reason why you need to include an email please use the "Need Help? Contact Us!" box or your Profile Box.

• Use "we" instead of "UNM Health Sciences Library and Informatics Center." Personal pronouns are more scannable and reduce text size. Users will know "we" refers to the Libraries.
• Don't put opening or closing hours in your text. Hours are subject to change, and your text will quickly become out-dated. Link to the Hours page instead.
• Don't use absolute directions/positions when referring to a specific box/column. Your guide is responsive and columns will shift around for different screen sizes. 
  • For example: "Additional information can be found in the Resources box."