Difference between revisions of "Style manual"

From CCS Cataloging Manual
Jump to navigation Jump to search
m (Redirected page to Catalogers Wiki:Manual of Style)
 
(One intermediate revision by one other user not shown)
Line 1: Line 1:
{{External|
#REDIRECT [[Catalogers Wiki:Manual of Style]]
* [https://www.usability.gov/how-to-and-tools/methods/writing-for-the-web.html usability.gov]}}
 
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  <nowiki>{{subfield|b}}</nowiki>, 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. <nowiki> {{External| * hyperlink }}</nowiki>
 
 
* 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.
[[Category:Commons]]
[[Category:Commons]]

Latest revision as of 21:08, 17 September 2018