Style manual

From CCS Cataloging Manual
Revision as of 18:13, 24 February 2017 by JohnLavalie (talk | contribs)
Jump to navigation Jump to search
External links

Suggestions from usability.gov:

General

  • When writing for the web, using plain language allows users to find what they need, understand what they have found, and then use it to meet their needs. It should also be actionable, findable, and shareable.
  • Chunk your content. Chunking makes your content more scannable by breaking it into manageable sections.
  • Use short sentences and paragraphs. The ideal standard is no more than 20 words per sentence, five sentences per paragraph.
  • Use bullets and numbered lists. Don’t limit yourself to using this for long lists—one sentence and two bullets is easier to read than three sentences.
  • Add keywords in sentences if that will help discovery and optimize for search engines. Don't just write "Macros". Use "OCLC Connexion Macros for Worldcat"
  • Use neutral, direct language. Instead of "Please remember to change...", just use "Change..."
  • Use the same kind of language found in OCLC Bibliographic Standards and Formats

Use templates

  • Subfield {{subfield|b}}, where b is the subfield. We can always define later what the subfield character is, a dagger, a pipe, a dollar sign, or change them in one fell swoop.
  • External links. Use template to put short list of links to applicable national practice (Bib Formats and Standards, OLAC documents, etc.) in box in upper right corner. {{External| * hyperlink }}


  • When writing up a local practice, describe briefly how this varies from national practice, and why CCS is doing it.
  • Cite RDA rule number if known, do not link.