DOCSLIB.ORG

OCLC Writing and Usage Guide

Total Page：16

File Type：pdf, Size：1020Kb

Download full-text PDF Read full-text
OCLC Writing and Usage Guide OCLC writing and usage guide Updated May 2016 Contents Introduction and acknowledgments .............................................................................................2 OCLC writing style ......................................................................................................................3 Word choices ..............................................................................................................................8 Numbers ...................................................................................................................................13 Punctuation guidelines ..............................................................................................................16 Vertical lists ...............................................................................................................................22 Writing for the web ....................................................................................................................23 English localization ...................................................................................................................25 Using trademarked words .........................................................................................................27 Resources .................................................................................................................................30 Appendix A: OCLC product and service names ........................................................................31 Appendix B: Print codes and regionalizations............................................................................44 1 Introduction and acknowledgments This guide is a living document that provides a record of accepted and recommended practices that inform the technical writing style for OCLC’s external communications. This guide covers the recommended writing style for both print and electronic messages for all OCLC communications, including marketing, research reports and documentation. The practices and conventions recommended in this guide are specific to OCLC but are derived at least in part from highly regarded sources that include The Chicago Manual of Style and Associated Press (AP) Stylebook. The OCLC Library holds print editions of each of these guides and offers electronic access to The Chicago Manual of Style. Although this guide was developed primarily for a US audience, other regions may find parts of it valuable, especially the list of OCLC product and service names (Appendix A: OCLC product and service names), the guidelines for using trademarked words and the localization guidelines. Please note that trademark symbols are not used in the examples that follow because this document is for internal use only. Significant portions of this guide are derived from the OCLC Style Guide originally authored by Judy Barnes, OCLC Service Division, primarily for use in OCLC documentation and support applications. This version, which is an update to the version released in May 2015, was prepared by Jennifer Smither with significant input from Brad Gauder and additional reviews by Amanda Brennen, Terry Butterworth, Mark Cooke, Jane Dishong, Sara Finch, Lauren Gallina, Andy Havens, Erin Hood, Jenny Johnson, Kem Lang, Bob Murphy, Merrilee Proffitt, Erin Schadt, Noelle Sicuro, Tom Storey, David Valentine-Elam and ME Woods. The current editable version of this guide resides on the marketing shared drive, under N:\prm4\214786 OCLC writing and usage guide. The next update to this guide is planned for April 2017. 2 OCLC writing style Acronyms Acronyms are acceptable as long as they are defined on first use. One obvious exception to this rule is “OCLC,” which should not be defined in most cases. Acronyms may be used in headings for brevity, but should be defined as soon as possible in the body copy. In general, do not use periods between the letters of an acronym. One exception is authors who prefer their initials when listed in a bibliography or citation. Press releases refer to the AP Stylebook, which calls for periods in “U.S.,” but most OCLC writing adheres to the rules in The Chicago Manual of Style, which does not include those periods. A plural of an acronym receives a lowercase “s” without an apostrophe. Examples: OCLC will present 12 sessions at this year’s American Library Association (ALA) Annual Conference in the US. ALA attracts many Associate University Librarians (AULs). That AUL’s name is Mr. Brown. Bibliographic citations Refer to The Chicago Manual of Style, Chapter 15, “Documentation II: Author-Date References” for guidance on how to format full citations, shortened in-line references and citations in end notes, footnotes, bibliographies and reference lists. In most cases, OCLC documents should use the author-date reference style, not the notes and bibliography reference style. Capitalization OCLC follows the basic capitalization rules laid out by third-party style guides of authority. The list below offers some OCLC-specific stylistic differences. In general, most words that are not proper nouns or do not begin a sentence should be lowercase. For more specific information, see The Chicago Manual of Style. Captions and labels In general, use sentence-style capitalization and punctuation for captions and image labels, which is friendlier and easier for the reader to skim. Capitalize the first word and proper names, but leave other words lowercase. Example: WorldCat holdings by type of library Example: Columbus Metropolitan Library hosted a member forum. Headings and subheadings Use sentence-style capitalization and punctuation for headings and subheadings. Capitalize the first word of the heading, proper names and the first word of the subheading, but leave other words lowercase. Example: Your partner to solve cataloging challenges Example: Do things differently so you have time to do different things. 3 Organizational names Generally, use initial capital letters for all parts of an organizational name except for conjunctions, prepositions and articles (if the article is not the first word). Some commercial organizations have a preferred capitalization style. Likewise, some official university names begin with “The,” and some have specific formats for the names of branch campuses. A best practice is to check the organization’s website and use the recommended capitalization shown there. Examples: Library of Congress, McGill University, The Ohio State University, EBSCO, WiLS Product names In general, capitalize the first letter of product names, but use lowercase for the names of product features and functionality. See Appendix A: OCLC product and service names for specific instructions. Professional titles For OCLC writing, use initial capital letters for titles whether they precede or follow a name. Example: Skip Prichard, OCLC President and CEO, spoke at last year’s ALA. Example: President and CEO Skip Prichard spoke at last year’s ALA. Example: OCLC’s President and CEO, Skip Prichard, spoke at last year’s ALA. Titles of works See Titles in this section, below. Contractions Contractions are widely accepted in OCLC material, especially marketing copy, because they are easier for most people to read. They may not be appropriate in every case, depending on the context of the document, the meaning of the sentence and the intended audience. Example: You’ll love our new service. Electronic or “e” entities Unless at the beginning of a sentence or as part of a title, use a lowercase “e-” followed by the named resource. Examples: e-book, e-content EXCEPTION: Do not hyphenate “email.” This word is so widely used without a hyphen that most readers are used to seeing it this way. 4 Parallel construction Use parallel construction for items in a list or in a series. The first word of each item should be the same part of speech (infinitive, noun, participle, gerund, etc.). Example: The resources include books, e-books and e-journals. Example: The three steps are: (1) locate the directory, (2) click the file you need and (3) edit text as needed. NOT The three steps are: (1) locating the directory, (2) click the file you need (3) to edit text as needed. Parenthetic expressions A parenthetic expression is a part of a sentence that can be omitted without changing the meaning of the sentence. Depending on its importance to the larger meaning of the sentence and the emphasis it should receive, a parenthetic expression can be set off with parentheses, commas or em dashes (see the Punctuation guidelines section for more information on using parentheses, commas and em dashes). Example: The Article Exchange Alert (a new feature with this release) indicates the number of items that require attention. Example: An effective search method, especially for skilled searchers, is to conduct a Boolean search. Example: All the issues you face—data migration, policy configuration and staff training—are ones we’ve helped many libraries with before. Passive voice In almost all cases, avoid passive voice. Rephrase the sentence to clearly state who did what. Please note that avoiding passive voice doesn’t mean avoiding the verb “to be”; indeed, any verb can appear in a passive sentence. To determine whether the sentence truly is passive, try adding “by zombies” to the end. If it makes grammatical sense, then it’s passive. Example: The lead gen team sent an email to webinar attendees. NOT An email was sent to webinar attendees (by zombies). Example: The Dublin branch library delivers books to OCLC
Load more

Recommended publications
  • Punctuation: Program 8-- the Semicolon, Colon, and Dash
    C a p t i o n e d M e d i a P r o g r a m #9994 PUNCTUATION: PROGRAM 8-- THE SEMICOLON, COLON, AND DASH FILMS FOR THE HUMANITIES & SCIENCES, 2000 Grade Level: 8-13+ 22 mins. DESCRIPTION How does a writer use a semicolon, colon, or dash? A semicolon is a bridge that joins two independent clauses with the same basic idea or joins phrases in a series. To elaborate a sentence with further information, use a colon to imply “and here it is!” The dash has no specific rules for use; it generally introduces some dramatic element into the sentence or interrupts its smooth flow. Clear examples given. ACADEMIC STANDARDS Subject Area: Language Arts–Writing • Standard: Uses grammatical and mechanical conventions in written compositions Benchmark: Uses conventions of punctuation in written compositions (e.g., uses commas with nonrestrictive clauses and contrasting expressions, uses quotation marks with ending punctuation, uses colons before extended quotations, uses hyphens for compound adjectives, uses semicolons between independent clauses, uses dashes to break continuity of thought) (See INSTRUCTIONAL GOALS 1-4.) INSTRUCTIONAL GOALS 1. To explain the proper use of a semicolon to combine independent clauses and in lists with commas. 2. To show the correct use of colons for combining information and in sentence fragments. 3. To illustrate the use of a dash in sentences. 4. To show some misuses of the semicolon, colon, and dash. BACKGROUND INFORMATION The semicolon, colon, and dash are among the punctuation marks most neglected by students and, sad to say, teachers. However, professional writers—and proficient writers in business—use them all to good effect.
    [Show full text]
  • Typing in Greek Sarah Abowitz Smith College Classics Department
    Typing in Greek Sarah Abowitz Smith College Classics Department Windows 1. Down at the lower right corner of the screen, click the letters ENG, then select Language Preferences in the pop-up menu. If these letters are not present at the lower right corner of the screen, open Settings, click on Time & Language, then select Region & Language in the sidebar to get to the proper screen for step 2. 2. When this window opens, check if Ελληνικά/Greek is in the list of keyboards on your ​ ​ computer under Languages. If so, go to step 3. Otherwise, click Add A New Language. Clicking Add A New Language will take you to this window. Look for Ελληνικά/Greek and click it. When you click Ελληνικά/Greek, the language will be added and you will return to the previous screen. 3. Now that Ελληνικά is listed in your computer’s languages, click it and then click Options. 4. Click Add A Keyboard and add the Greek Polytonic option. If you started this tutorial without the pictured keyboard menu in step 1, it should be in the lower right corner of your screen now. 5. To start typing in Greek, click the letters ENG next to the clock in the lower right corner of the screen. Choose “Greek Polytonic keyboard” to start typing in greek, and click “US keyboard” again to go back to English. Mac 1. Click the apple button in the top left corner of your screen. From the drop-down menu, choose System Preferences. When the window below appears, click the “Keyboard” icon.
    [Show full text]
  • List of Approved Special Characters
    List of Approved Special Characters The following list represents the Graduate Division's approved character list for display of dissertation titles in the Hooding Booklet. Please note these characters will not display when your dissertation is published on ProQuest's site. To insert a special character, simply hold the ALT key on your keyboard and enter in the corresponding code. This is only for entering in a special character for your title or your name. The abstract section has different requirements. See abstract for more details. Special Character Alt+ Description 0032 Space ! 0033 Exclamation mark '" 0034 Double quotes (or speech marks) # 0035 Number $ 0036 Dollar % 0037 Procenttecken & 0038 Ampersand '' 0039 Single quote ( 0040 Open parenthesis (or open bracket) ) 0041 Close parenthesis (or close bracket) * 0042 Asterisk + 0043 Plus , 0044 Comma ‐ 0045 Hyphen . 0046 Period, dot or full stop / 0047 Slash or divide 0 0048 Zero 1 0049 One 2 0050 Two 3 0051 Three 4 0052 Four 5 0053 Five 6 0054 Six 7 0055 Seven 8 0056 Eight 9 0057 Nine : 0058 Colon ; 0059 Semicolon < 0060 Less than (or open angled bracket) = 0061 Equals > 0062 Greater than (or close angled bracket) ? 0063 Question mark @ 0064 At symbol A 0065 Uppercase A B 0066 Uppercase B C 0067 Uppercase C D 0068 Uppercase D E 0069 Uppercase E List of Approved Special Characters F 0070 Uppercase F G 0071 Uppercase G H 0072 Uppercase H I 0073 Uppercase I J 0074 Uppercase J K 0075 Uppercase K L 0076 Uppercase L M 0077 Uppercase M N 0078 Uppercase N O 0079 Uppercase O P 0080 Uppercase
    [Show full text]
  • Top Ten Tips for Effective Punctuation in Legal Writing
    TIPS FOR EFFECTIVE PUNCTUATION IN LEGAL WRITING* © 2005 The Writing Center at GULC. All Rights Reserved. Punctuation can be either your friend or your enemy. A typical reader will seldom notice good punctuation (though some readers do appreciate truly excellent punctuation). However, problematic punctuation will stand out to your reader and ultimately damage your credibility as a writer. The tips below are intended to help you reap the benefits of sophisticated punctuation while avoiding common pitfalls. But remember, if a sentence presents a particularly thorny punctuation problem, you may want to consider rephrasing for greater clarity. This handout addresses the following topics: THE COMMA (,)........................................................................................................................... 2 PUNCTUATING QUOTATIONS ................................................................................................. 4 THE ELLIPSIS (. .) ..................................................................................................................... 4 THE APOSTROPHE (’) ................................................................................................................ 7 THE HYPHEN (-).......................................................................................................................... 8 THE DASH (—) .......................................................................................................................... 10 THE SEMICOLON (;) ................................................................................................................
    [Show full text]
  • Clarifying Punctuation
    Clarifying Punctuation Punctuation was created to aid readers. Without it, ideas run together and your reader may misinterpret your ideas. Here are guidelines for use on these pieces of punctuation: commas, semicolons and colons. COMMAS Use a comma when joining two complete sentences with a conjunction such as “but” or “and.” Example: I ate dinner, but I did not eat dessert. Example: I ate dinner, and I ate dessert. Do not use a comma if the second group of words is not a complete sentence. Example: I ate my dinner and also ate dessert. Use a comma after an introductory phrase or word. Example: Because I am a college student with no money, I ate dinner at home. Use a comma between items in a list. Example: My dinner consisted of a sandwich, soup, and salad. Use a comma to separate words that interrupt the flow of a sentence or modify a noun. Example: Casey, my dog, ate the dinner right off my plate! Example: Without hesitation, my mother scolded Casey for eating my dinner. Use a comma when introducing quotations. Example: My mother yelled, “Dinner time!” SEMICOLONS Use a semicolon to join two complete sentences that are related. If a period, which allows a breath when reading aloud, seems unnecessary, replace it with a semicolon. Example: My mother made dinner; the dinner tasted delicious. Use a semicolon with words like “however” or phrases like “for example.” Example: I ate dinner; however, I was hungry an hour later. Use a semicolon to clarify a list of items that already contains punctuation.
    [Show full text]
  • Examples of Sentences Using Quotation Marks
    Examples Of Sentences Using Quotation Marks Biogenous Parrnell misquotes presumingly while Sloane always overprizes his Goidelic interlaid semplice, he unhumanizes so insanely. Brilliant-cut Goose sometimes disafforest his maximum eastward and buss so strategically! Coronary Moises canvasses epigrammatically. This section for direct speech is to forget the quote remain in the proposition that the street in using quotation of examples sentences Either way, they are a very important type of punctuation! Everything else is secondary. Glad the post was helpful. This is a string in Markdown. Maybe a pirate ship. Put question marks and exclamation marks inside the quotation marks if the marks relate directly and only to the text within quotation marks. Jill told her mother. Come get a treat! Inside the US, inside the quotation marks. However, the closing quotation mark is only applied to the paragraph that contains the end of the quote. Why is it such a big deal? On the mysteries of combining quotation marks with other punctuation marks. Quotation marks used around words to give special effect or to indicate irony are usually unnecessary. DOL grammar, spelling and vocabulary lists, and assorted worksheets. The alien spaceship appeared right before my own two eyes. What time is the meeting? Perhaps the price was too high or you decided to go with another company. Nikki: The comma is perfect where it is. Punctuation marks are tools that have set functions. For those of you familiar with British English conventions, this is a change in style. Note first that what is enclosed in quotes must be the exact words of the person being quoted.
    [Show full text]
  • Thu Apr 08 2021
    APRIL 8, 2021 667 Journal of the House FIFTY-EIGHTH DAY HALL OF THE HOUSE OF REPRESENTATIVES, TOPEKA, KS, Thursday, April 8, 2021, 10:00 a.m. The House met pursuant to adjournment with Speaker Ryckman in the chair. The roll was called with 123 members present. Rep. Howard was excused on verified illness. Rep. Sutton was excused on excused absence by the Speaker. Excused later: Reps. Barker, Lynn and Victors. Present later: Reps. Barker and Sutton. Prayer by Chaplain Brubaker: Loving and Caring God, thank You for this day. As our leaders continue to travel through their work, be the wind in their sails. Help them to allow You to steer and guide them in the right direction. Give them strength to keep going. Watch over them as they navigate stormy issues. Be their harbor when they need rest. Be their encouragement when they begin to lose hope. Be the light when things seem the darkest. Be the hand that reaches out to them when they are overwhelmed and feel they are drowning. You are the lighthouse that provides them confidence and safety. For this, I thank You and pray in Your Name, Amen. The Pledge of Allegiance was led by Rep. Borjon. PERSONAL PRIVILEGE There being no objection, the following remarks of Rep. Ballard are spread upon the Journal: March is designated Women’s History Month, but we adjourned early for Easter before we could present our planned program. The 2021 theme is a continuation of 2020’s “Valiant Women of the Vote: Refusing to be Silenced.” This theme recognizes the battle for over 70 years for Women’s Right to Vote, which was gained with the passage of the 19th Amendment in 1920.
    [Show full text]
  • Effective Punctuation
    Effective Punctuation Contents: 1. Oxford commas 2. Parenthetic phrases 3. Independent clauses 4. Punctuation before or after quotation marks 5. Ellipses in quotations 6. Em dashes 7. One or two spaces after periods 8. When to capitalize after colons 1. Oxford Comma Writers disagree on whether lists of three or more should include a comma before the “and” (or “or”) and the last item in the list. Above all, consistency is key. If you do not know your reader's preference, choose one method and stick to it. Commas before the last “and” must be used when the final item in the list itself contains a conjunction (e.g., “He was charged with assault, battery, and breaking and entering.”) Option 1 Option 2 When the “Oxford Comma” is required The American flag is red, The American flag is red, You are charged with white and blue. white, and blue. trespassing, burglary, and assault and battery. 2. Parenthetic phrases Use commas to set off words and phrases that do not neatly fit into the main grammatical structure of the sentence. Nonrestrictive clauses are examples of parenthetic phrases. Unless the parenthetic phrase ends the sentence, there should always be a comma at the end of the parenthetic phrase. Do not use commas to set off phrases that, if removed, would change the meaning of the sentence, i.e., a restrictive clause. • Examples: o The Constitution, which was signed in 1787, is the supreme law of the land. o The Constitution, signed in 1787, is the supreme law of the land. o The judge, however, was not amused.
    [Show full text]
  • Grammar Workshop – Punctuation II: Semi-Colon, Colon, Apostrophe
    [email protected] Punctuation II: Semi-colons, Colons, and Apostrophes When to use a Semi-colon: 1. To join independent clauses in compound sentences that do not have a coordinating conjunction (and, or, but..) and commas as connectors. You can use connector words such as “however,” “thus,” “moreover,” and “therefore” in these sentences. EX. The shirt was $150; however, it was originally $300 before going on the sale rack. There was no running and shouting; all the children behaved well; therefore, they will all get a cookie. Working mothers pay an average of $55 a week for child care; this means that many women pay nearly half of their weekly salary to child care workers. 2. To join long or complicated items in a series that already has commas. EX. The instructors were Dr. Manly Wall, Philosophy; Dr. Sara Gilman, Genealogy; and Dr. Andrew Smith, Biological Anthropology. I recommend this doctor because she communicates well with patients, colleagues, and pharmacists; is prompt during services; and has won several awards for service and research. 3. To separate long or complex independent clauses that are joined by coordinating conjunctions, and that cannot be joined by a comma because the sentence would be confusing. EX. Sarah, the head chef, wants to teach the culinary arts class, the sugar sculpture class, and the specialty cake class at the local community college; but her schedule during the week does not permit her to teach the classes at night, which is when most students would be able to attend. When to use a Colon: 1. After an independent clause that precedes a list.
    [Show full text]
  • Punctuation Mistakes in the English Writing of Non-Anglophone Researchers
    J Korean Med Sci. 2020 Sep 21;35(37):e299 https://doi.org/10.3346/jkms.2020.35.e299 eISSN 1598-6357·pISSN 1011-8934 Opinion Punctuation Mistakes in the English Editing, Writing & Publishing Writing of Non-Anglophone Researchers Tatyana Yakhontova Department of Foreign Languages for Natural Sciences, Ivan Franko National University of Lviv, Lviv, Ukraine Received: Jul 14, 2020 Punctuation mistakes of non-Anglophone researchers often remain unnoticed and Accepted: Jul 28, 2020 unaddressed by researchers themselves, peer reviewers, journal editors, and English language Address for Correspondence: instructors. There are a number of factors complicating the current situation with often Tatyana Yakhontova, Dr. Habil., Prof overlooked punctuation mistakes. Firstly, punctuation is often viewed as a less important Department of Foreign Languages for Natural subject when compared to other areas of writing difficulties,1 such as organization of Sciences, Ivan Franko National University of scientific ideas, choice of persuasion strategies, text structure, sentence grammar, and Lviv, 41 Doroshenka St., Lviv 79000, Ukraine. appropriate style.2 Furthermore, there is a wide variation in the use of punctuation even by E-mail: [email protected] native English speakers due to insufficient attention to its main rules in language classes.3 © 2020 The Korean Academy of Medical Finally, with the unprecedented growth of the number of nonnative English speakers, certain Sciences. deviations from language style and punctuation standards seem to become more accepted. In This is an Open Access article distributed fact, some top journals have switched to flexible instructions, displaying greater tolerance of under the terms of the Creative Commons 4 Attribution Non-Commercial License (https:// minor language inconsistencies in the writing of non-Anglophone researchers.
    [Show full text]
  • Rule 1. to Avoid Confusion, Use Commas to Separate Words And
    BASIC RULES OF GRAMMAR A paragraph is a unit of thought that develops an idea. A traditional paragraph contains a topic sentence that states the idea to be developed, plus additional sentences that develop the idea stated by the topic sentence. In U.S. formal academic English, paragraphs have three principal parts. These three parts are the topic sentence, body sentences, and the concluding sentence. (http://lrs.ed.uiuc.edu/students/fwalters/para.html) Comma Rule To avoid confusion, use commas to separate words and word groups 1. with a series of three or more. Example: My $10 million estate is to be split among my husband, daughter, son, and nephew. Omitting the comma after son would indicate that the son and nephew would have to split one-third of the estate. Rule Use a comma to separate two adjectives when the word and can be 2. inserted between them. Examples: He is a strong, healthy man. We stayed at an expensive summer resort. You would not say expensive and summer resort, so no comma. Rule Use a comma when an -ly adjective is used with other adjectives. 3. NOTE: To test whether an -ly word is an adjective, see if it can be used alone with the noun. If it can, use the comma. Examples: Felix was a lonely, young boy. I get headaches in brightly lit rooms. Brightly is not an adjective because it cannot be used alone with rooms; therefore, no comma is used between brightly and lit. 1 Rule Use commas before or surrounding the name or title of a person 4.
    [Show full text]
  • KNOWING WHEN to STOP: IS the PUNCTUATION of the CONSTITUTION BASED on SOUND OR SENSE? Michael Nardella* No Person Shall Be Held
    KNOWING WHEN TO STOP: IS THE PUNCTUATION OF THE CONSTITUTION BASED ON SOUND OR SENSE? Michael Nardella* No person shall be held to answer for a capital, or otherwise infamous crime, unless on a presentment or indictment of a Grand Jury, except in cases arising in the land or naval forces, or in the Militia, when in actual service in time of War or public danger; nor shall any person be subject for the same offence to be twice put in jeopardy of life or limb; nor shall be compelled in any criminal case to be a witness against himself, nor be deprived of life, liberty, or property, without due process of law; nor shall private property be taken for public use without just compensation.1 I. INTRODUCTION. ....................................668 II. THE DRAFTING HISTORY OF THE FIFTH AMENDMENT........670 A.The Punctuation of the Drafting Process. .............670 B.The Punctuation of Compromise?....................673 III. HISTORICAL AND CURRENT PUNCTUATION: LOOKING AT THE MUSIC OF LANGUAGE.............................675 A.The General History of Punctuation..................675 B.The Eighteenth-Century English Grammars............677 C.The Many Essays on Punctuation....................679 D.The Rhetorical Grammars..........................680 E.The Counter-Revolution: Logic Prevails...............682 F.Punctuation: Then and Now. .......................683 IV. CHAOS, CADENCE, OR COMPROMISE: WHAT IS A SEMICOLON ANYWAY?.........................................685 A.The Possible Explanations..........................685 1. Is It Just Chaos?...............................685 2. Is It Syntactic, but Highly Complex?. 686 3. Is It Just a Typo?...............................688 4. Is It the Child of Compromise?. 689 * I would like to thank Lars Noah, genius operis meus; Jeffrey Bekiares, who wasn’t too bashful to give good criticism; Gretchen Lehman, regina grammatices; and Flaminack & O’Quinn, P.C.
    [Show full text]