Folgerpedia:Manual of Style/Cataloging: Difference between revisions

(Re-arranged content)
 
(47 intermediate revisions by 3 users not shown)
Line 1: Line 1:
This article elaborates on the Folgerpedia Manual of Style for articles about cataloging and metadata topics. Anything not covered here defaults there.
This article elaborates on the Folgerpedia Manual of Style for articles about cataloging and metadata topics. Anything not covered here defaults there.


==Style==
==Style==
* Prefer imperative language when giving instructions. For example, "Make a note" instead of "A note should be made."
* Prefer imperative language when giving instructions. For example, "Make a note" instead of "A note should be made."
* Avoid unnecessary catalogerese. Pretend these articles will be read by a non-specialist interested in cataloging.
* Avoid unnecessary catalogerese. These articles are being read not only by catalogers, but by non-specialists interested in cataloging.
* Refer to staff by role or job title, not name.
* Refer to staff by role or job title, not name.
* Spell out abbreviations, especially the Latin abbreviations ''e.g.'' and ''i.e.''
* Spell out abbreviations, or avoid them entirely. Use "for example" and "that is" instead of the Latin abbreviations ''e.g.'' and ''i.e.''  
* Use preformatted text for examples.
* Use [[#Formatting|preformatted text]] for examples.


==Terminology==
==Terminology==
* Use '''call number''' instead of '''shelfmark'''.
* Use ''call number'' instead of ''shelfmark''.
* ''Hamnet'' refers to public-facing MARC records. Prefer "Hamnet" if the context encompasses both public and cataloger information
* ''Hamnet'' refers to public-facing MARC records. Prefer "Hamnet" if the context encompasses both public and cataloger information.
:: <code> Multiple works bound together subsequent to publication will have multiple bibliographic records in Hamnet, one for each separate title.</code>
* ''Voyager'' refers to the ILS as a whole. Prefer "Voyager" when talking about the settings and capabilities of the software.
:<code> When catalog records in Hamnet carry an advisory statement, it's usually for one of two situations ...</code>
* Use "At the Folger ..." to distinguish local Voyager customizations.
* ''Voyager'' refers to the ILS as a whole
*Examples:
** Use "At the Folger ..." to distinguish between what we can customize in Voyager and what we can’t.
:<pre>Multiple works bound together subsequent to publication will have multiple bibliographic records in Hamnet, one for each separate title.</pre>
:: <code> At the Folger, Voyager indexes 008 and the 046 dates in Hamnet and the staff modules. </code>
:<pre>Voyager indexes only 852ǂh and 852ǂi for left-anchored call number searches.</pre>
:: <code>Voyager indexes only 852|h and 852|i for left-anchored call number search.</code>
:<pre>At the Folger, Voyager indexes 008 and the 046 dates in Hamnet and the staff modules.</pre>
 
==Article titles, headings, and sections==
*Name articles without particular reference to cataloging. For example: [[Loose material in or from collection items]]. This allows an article to bring together all information about a topic, of which cataloging policy is one. If an article becomes too lengthy, cataloging policy can be separated into a subpage.
*Take care to follow [[Folgerpedia:Manual of Style]] by always providing a lead section followed by a level 2 heading.


==Content==
==Content==
* Resist the temptation to arrange the instructions in full syndetic structure. Aim for only two or three levels of hierarchy. Even if the lead section is not specific to cataloging, do not create a level for "Cataloging instructions."
* Resist the temptation to arrange the instructions in full syndetic structure. Aim for only two or three levels of hierarchy.  
* Generally, create a level for "Cataloging instructions," even if that is the only content in the article at that time. For example, here's a screenshot of the [[Sermons]] page when it contained only cataloging information:
[[File:SermonsArticle20180822.JPG]]


==Article titles, headings, and sections==  
==Formatting==
* Name articles without particular reference to cataloging. For example: [[Things in books]]. This allows an article to bring together all information about a topic, of which cataloging policy is one. If an article becomes too lengthy, cataloging policy can be separated into a subpage.
*Use preformatted text for examples or display of exact strings to be used. There are several ways to tag preformatted text.
* Formulate article names about [[MARC]] fields in this way:  
*Format examples so that the box aligns with the text being exemplified.  
:: MARC [tag] [Name of Field from the MARC Format]
**If the text is not indented, you may either simply insert an initial blank space (easiest), or the tag for preformatted text: <nowiki><pre></pre></nowiki>
*Follow the MARC format's capitalization of field names
**If the text is indented (typically by a bullet), use a colon and the tag for preformatted text: <nowiki>:<pre></pre></nowiki>
*Additional instructions below under [[#Articles on MARC fields]]
**If an exact string is inserted within regular text, use: <nowiki><code></code></nowiki>
**If inserting an example in a double bullet followed by another double bullet, use  <nowiki><code></code></nowiki>.
*Rely on the presence of preformatted text for examples instead of using the label "Examples:" if it simplifies the tagging.


==Articles on MARC fields==
==Articles on MARC fields==
*Use the [[Template for MARC articles]]
*Formulate the title by copy-and-pasting the heading from the online MARC field; leave off the "(R)" or "(NR)"
* If the field exists in two or more formats and is essentially identical, enumerate all format names in the lead section using the short form. The formal and short titles of the format names are:
: [http://www.loc.gov/marc/authority authority format]
: [http://www.loc.gov/marc/bibliographic/ bibliographic format ]
: [http://www.loc.gov/marc/holdings/ holdings format]
* Begin lead section with these or similar words:  
* Begin lead section with these or similar words:  
:: MARC field XXX in the bibliographic format contains <...>  
:<pre> MARC field XXX in the bibliographic format contains ... </pre>
* If the field exists in two or more formats and is essentially identical, enumerate all format names in the lead section using the short form. The formal and short titles of the format names are:
* If a field that exists in different formats has different definitions (as does 046 in [[MARC 046 Special Coded Dates (Authority) |authority]] and [[MARC 046 Special Coded Dates (Bibliographic)|bibliographic]] formats, create separate articles. Disambiguate by putting the format in parentheses after the name of the field.
** [[MARC 21 Format for Bibliographic Data]] / bibliographic format
** [[MARC 21 Format for Holdings Data]] / holdings format
** [[MARC 21 Format for Authority Data]] / authority format
* If the field has different definitions (as does 046 in [[MARC 046 Special Coded Dates|bibliographic]] and authority formats), create separate articles. Disambiguate by putting the format in parentheses after the name of the field
* These articles integrate policy and instructions on content ''and'' mark-up; we are using the MARC field as a shortcut for the corresponding AACR2 and RDA elements.   
* These articles integrate policy and instructions on content ''and'' mark-up; we are using the MARC field as a shortcut for the corresponding AACR2 and RDA elements.   
* Elements of articles on MARC fields usually include:
* Elements of articles on MARC fields usually include:
** A lead sentence. In general, copy the remaining part of the lead section from the Field Definition and Scope from the MARC format, truncating or editing as desired. Example:
** A lead sentence. In general, copy the remaining part of the lead section from the Field Definition and Scope from the MARC format, truncating or editing as desired.  
::: MARC field 856 in the bibliographic and holdings format contains information needed to locate and access an electronic resource in a Hamnet record. The field may be used in a bibliographic record for a resource when that resource or a subset of it is available electronically. In addition, it may be used to locate and access an electronic version of a non-electronic resource described in the bibliographic record or a related electronic resource.  
<code>MARC field 856 in the bibliographic and holdings format contains information needed to locate and access an electronic resource. The field may be used in a bibliographic record for a resource when that resource or a subset of it is available electronically. In addition, it may be used to locate and access an electronic version of a non-electronic resource described in the bibliographic record or a related electronic resource. This field is repeatable.</code>
** a section on "Commonly-used tags" containing the most commonly used indicators and subfields  
**A section on "Commonly-used tags" containing the most commonly used indicators and subfields. Policy and formulation relating only to single subfields may be included in this section. 
** a section on "Policy and formulation," or as two separate sections if content is extensive
**A section on "Policy and formulation," for general policies, or those that cover more than one subfield.
** Folger policy statements, style, and interpretations of cataloging instructions, but not basic cataloging instruction itself; compare to LCC/PC Policy Statements
** Folger policy statements, style, and interpretations of cataloging instructions, but, in general, not basic cataloging instruction itself; compare to LCC/PC Policy Statements
* Make redirects from the name of the MARC field. For example, [[MARC 852]] redirects to [[MARC 852 Location]]. However, do not redirect from more ambiguous terms, such as "852," which was the original title of the article.  
*External links.
* Use a double dagger (ǂ) for subfield delimiters.  
**Authority format: to the MARC 21 Format for Authority Data link at loc.gov, to the corresponding authority format link in Cataloger's Desktop, and to the Descriptive Cataloging Manual–Public Sections link in Cataloger's Desktop.
**Bibliographic format: to the MARC 21 Format for Bibliographic Data link at loc.gov, to the corresponding bibliographic format link in Cataloger's Desktop, and to the OCLC MARC guide for the tag.
**Holdings format: to the MARC 21 Format for Holdings Data link at loc.gov.
**If the MARC tag is included in two formats and the information is essentially the same, in general make links only to one format.  
*Generally, use a double dagger (ǂ) for subfield delimiters. If providing preformatted text appropriate for use in a catalog record, format for copy-and-paste according to Connexion or Voyager, depending on where the text is expected to be used.


==[[Advisory statements]]==
==[[Advisory statements]]==
*Advisory statements come first on a page, preceding the lead section.
Advisory statements come first on a page, preceding the lead section.
* Use '''<nowiki>{{Draft}}</nowiki>''' while a new article from scratch or one combining information from several sources is in process. Remove it when the article is substantially usable, even if not complete.  
* Use '''<nowiki>{{Draft}}</nowiki>''' when creating a new article from scratch or one combining information from several sources is in process. Use sparingly; remove when the article is substantially usable, even if not complete.
* Use  '''<nowiki>{{Legacy}}</nowiki>''' when copying and pasting from Bard pages or other sources and there's uncertainty about whether the instructions are current and authoritative.     
* Use '''<nowiki>{{Draft-section}}</nowiki>''' when the statement applies only to one or more sections in an article.
*Use  '''<nowiki>{{Legacy}}</nowiki>''' when copying and pasting from Bard pages or other sources and there's uncertainty about whether the instructions are current and authoritative.     
* Use '''<nowiki>{{Legacy-section}}</nowiki>''' when the statement applies only to one or more sections in an article.
* Use '''<nowiki>{{Outdated}}</nowiki>''' when copying and pasting from Bard pages or other sources and it's known that some of the content is obsolete.
* Use '''<nowiki>{{Outdated}}</nowiki>''' when copying and pasting from Bard pages or other sources and it's known that some of the content is obsolete.
* Use '''<nowiki>{{Incomplete}}</nowiki>''' for articles that are meant to cover a broad area, but the content is narrow.  For example, [[Conservation]], which contains content only about conservation issues catalogers face
* Use '''<nowiki>{{Outdated-section}}</nowiki>''' when the statement applies only to one or more sections in an article.
* Use '''<nowiki>{{Incomplete}}</nowiki>''' for articles that are meant to cover a broad area, but the current content covers only a very narrow area.   
* Use '''<nowiki>{{Incomplete-section}}</nowiki>''' when the statement applies only to one or more sections in an article.


==Redirects==
==Redirects==
When moving (renaming) a page, the system defaults to creating a redirect. Retain the redirect, even if the change was as minor as different capitalization. This will preserve linkage to the moved article that exist in other pages.  
When moving (renaming) a page, the system defaults to creating a redirect. Retain the redirect, even if the change was as minor as different capitalization. This will preserve linkage to the moved article that exist in other pages.  
==Migration==
* Add newly-migrated articles to [[List of cataloging pages migrated from Bard]]
* Cataloging information is spread among several sources. Search these
** [http://bard.folger.edu/cgi-bin/view.pl/Main/CentralLibrary/CatMain Bard]
** [http://shcolcatalogingproject.pbworks.com/w/page/39690608/ShCol%20Cataloging%20Project%20Front%20Page pbworks]
** [file://\\nerissa\CentralLibrary\Cataloging\Cataloging%20website.html| Old cataloging website]. Most of the pertinent information had been migrated to Bard, but there may be small oases of hidden information.
* Refrain from doing any editing except for what is necessary to create and format the article. Add Advisory statements as appropriate
* Once a page has been migrated, add a statement to the effect and a link to the Folgerpedia article.
: <pre>This is an archived version of this article. For the most up-to-date version, see: [URL] </pre>
: <pre>Migrated to [URL]</pre>
* If only a portion of a Bard or pbworks page is migrated, strike through the migrated text.
* If none of the content of an existing Bard page is relevant (for example, pages made specifically for projects that have ended), do not migrate.


==External links==
==External links==
* Add "External links" as the final section of an article.  
* Add "External links" as the final section of an article.  
* Add a link to the [www.loc.gov/marc/| MARC field] for all MARC-based articles.  
* Add a link to the [http://www.loc.gov/marc/ MARC field] for all MARC-based articles.  
* Other external links may be added if particularly helpful, such as LC or OCLC.  
* Other external links may be added if particularly helpful, such as LC or OCLC.  


==Categories==
==Categories==
* Add these categories to all articles on cataloging:  
* Add these categories to all articles on cataloging:  
: <nowiki>[[Category:Description]]</nowiki>  
: <nowiki>[[Category:Cataloging]]</nowiki>  
: <nowiki>[[Category:Staff policies and procedures]]</nowiki>
: <nowiki>[[Category:Staff policies and procedures]]</nowiki>
* Add categories for material types only when an article is specific to one or two material types. Otherwise, the ''Description'' category is enough.
* Add categories for material types only when an article is specific to one or two material types.  
* Categories are a controlled vocabulary in Folgerpedia; other categories may be proposed, but not used before approval. 
* Categories are a controlled vocabulary in Folgerpedia; other categories may be proposed to the Folgerpedia team


==Talk page==
==Talk page==
Line 90: Line 93:
* Once the issue is resolved, strike through the text.
* Once the issue is resolved, strike through the text.


==Archive ==
===Migration===
* Add newly-migrated articles to [[List of cataloging pages migrated from Bard]]
* Cataloging information is spread among several sources. Search these
** [http://bard.folger.edu/cgi-bin/view.pl/Main/CentralLibrary/CatMain Bard]
** [http://shcolcatalogingproject.pbworks.com/w/page/39690608/ShCol%20Cataloging%20Project%20Front%20Page pbworks]
** [file://\\nerissa\CentralLibrary\Cataloging\Cataloging%20website.html Old cataloging website]. Most of the pertinent information had been migrated to Bard, but there may be small oases of hidden information.
* Refrain from doing any editing except for what is necessary to create and format the article. Add Advisory statements as appropriate
* Once a page has been migrated, add a statement to the effect and a link to the Folgerpedia article.
: <pre>This is an archived version of this article. For the most up-to-date version, see: [URL] </pre>
: <pre>Migrated to [URL]</pre>
* If only a portion of a Bard or pbworks page is migrated, strike through the migrated text.
* If none of the content of an existing Bard page is relevant (for example, pages made specifically for projects that have ended), do not migrate.


[[Category: Folgerpedia]]
[[Category: Folgerpedia]]
[[Category: Staff policies and procedures]]
[[Category: Staff policies and procedures]]
[[Category:Cataloging]]
[[Category:Cataloging]]

Latest revision as of 14:41, 22 August 2018

This article elaborates on the Folgerpedia Manual of Style for articles about cataloging and metadata topics. Anything not covered here defaults there.

Style

  • Prefer imperative language when giving instructions. For example, "Make a note" instead of "A note should be made."
  • Avoid unnecessary catalogerese. These articles are being read not only by catalogers, but by non-specialists interested in cataloging.
  • Refer to staff by role or job title, not name.
  • Spell out abbreviations, or avoid them entirely. Use "for example" and "that is" instead of the Latin abbreviations e.g. and i.e.
  • Use preformatted text for examples.

Terminology

  • Use call number instead of shelfmark.
  • Hamnet refers to public-facing MARC records. Prefer "Hamnet" if the context encompasses both public and cataloger information.
  • Voyager refers to the ILS as a whole. Prefer "Voyager" when talking about the settings and capabilities of the software.
  • Use "At the Folger ..." to distinguish local Voyager customizations.
  • Examples:
Multiple works bound together subsequent to publication will have multiple bibliographic records in Hamnet, one for each separate title.
Voyager indexes only 852ǂh and 852ǂi for left-anchored call number searches.
At the Folger, Voyager indexes 008 and the 046 dates in Hamnet and the staff modules.

Article titles, headings, and sections

  • Name articles without particular reference to cataloging. For example: Loose material in or from collection items. This allows an article to bring together all information about a topic, of which cataloging policy is one. If an article becomes too lengthy, cataloging policy can be separated into a subpage.
  • Take care to follow Folgerpedia:Manual of Style by always providing a lead section followed by a level 2 heading.

Content

  • Resist the temptation to arrange the instructions in full syndetic structure. Aim for only two or three levels of hierarchy.
  • Generally, create a level for "Cataloging instructions," even if that is the only content in the article at that time. For example, here's a screenshot of the Sermons page when it contained only cataloging information:

SermonsArticle20180822.JPG

Formatting

  • Use preformatted text for examples or display of exact strings to be used. There are several ways to tag preformatted text.
  • Format examples so that the box aligns with the text being exemplified.
    • If the text is not indented, you may either simply insert an initial blank space (easiest), or the tag for preformatted text: <pre></pre>
    • If the text is indented (typically by a bullet), use a colon and the tag for preformatted text: :<pre></pre>
    • If an exact string is inserted within regular text, use: <code></code>
    • If inserting an example in a double bullet followed by another double bullet, use <code></code>.
  • Rely on the presence of preformatted text for examples instead of using the label "Examples:" if it simplifies the tagging.

Articles on MARC fields

  • Use the Template for MARC articles
  • Formulate the title by copy-and-pasting the heading from the online MARC field; leave off the "(R)" or "(NR)"
  • If the field exists in two or more formats and is essentially identical, enumerate all format names in the lead section using the short form. The formal and short titles of the format names are:
authority format
bibliographic format
holdings format
  • Begin lead section with these or similar words:
 MARC field XXX in the bibliographic format contains ... 
  • If a field that exists in different formats has different definitions (as does 046 in authority and bibliographic formats, create separate articles. Disambiguate by putting the format in parentheses after the name of the field.
  • These articles integrate policy and instructions on content and mark-up; we are using the MARC field as a shortcut for the corresponding AACR2 and RDA elements.
  • Elements of articles on MARC fields usually include:
    • A lead sentence. In general, copy the remaining part of the lead section from the Field Definition and Scope from the MARC format, truncating or editing as desired.

MARC field 856 in the bibliographic and holdings format contains information needed to locate and access an electronic resource. The field may be used in a bibliographic record for a resource when that resource or a subset of it is available electronically. In addition, it may be used to locate and access an electronic version of a non-electronic resource described in the bibliographic record or a related electronic resource. This field is repeatable.

    • A section on "Commonly-used tags" containing the most commonly used indicators and subfields. Policy and formulation relating only to single subfields may be included in this section.
    • A section on "Policy and formulation," for general policies, or those that cover more than one subfield.
    • Folger policy statements, style, and interpretations of cataloging instructions, but, in general, not basic cataloging instruction itself; compare to LCC/PC Policy Statements
  • External links.
    • Authority format: to the MARC 21 Format for Authority Data link at loc.gov, to the corresponding authority format link in Cataloger's Desktop, and to the Descriptive Cataloging Manual–Public Sections link in Cataloger's Desktop.
    • Bibliographic format: to the MARC 21 Format for Bibliographic Data link at loc.gov, to the corresponding bibliographic format link in Cataloger's Desktop, and to the OCLC MARC guide for the tag.
    • Holdings format: to the MARC 21 Format for Holdings Data link at loc.gov.
    • If the MARC tag is included in two formats and the information is essentially the same, in general make links only to one format.
  • Generally, use a double dagger (ǂ) for subfield delimiters. If providing preformatted text appropriate for use in a catalog record, format for copy-and-paste according to Connexion or Voyager, depending on where the text is expected to be used.

Advisory statements

Advisory statements come first on a page, preceding the lead section.

  • Use {{Draft}} when creating a new article from scratch or one combining information from several sources is in process. Use sparingly; remove when the article is substantially usable, even if not complete.
  • Use {{Draft-section}} when the statement applies only to one or more sections in an article.
  • Use {{Legacy}} when copying and pasting from Bard pages or other sources and there's uncertainty about whether the instructions are current and authoritative.
  • Use {{Legacy-section}} when the statement applies only to one or more sections in an article.
  • Use {{Outdated}} when copying and pasting from Bard pages or other sources and it's known that some of the content is obsolete.
  • Use {{Outdated-section}} when the statement applies only to one or more sections in an article.
  • Use {{Incomplete}} for articles that are meant to cover a broad area, but the current content covers only a very narrow area.
  • Use {{Incomplete-section}} when the statement applies only to one or more sections in an article.

Redirects

When moving (renaming) a page, the system defaults to creating a redirect. Retain the redirect, even if the change was as minor as different capitalization. This will preserve linkage to the moved article that exist in other pages.

External links

  • Add "External links" as the final section of an article.
  • Add a link to the MARC field for all MARC-based articles.
  • Other external links may be added if particularly helpful, such as LC or OCLC.

Categories

  • Add these categories to all articles on cataloging:
[[Category:Cataloging]]
[[Category:Staff policies and procedures]]
  • Add categories for material types only when an article is specific to one or two material types.
  • Categories are a controlled vocabulary in Folgerpedia; other categories may be proposed to the Folgerpedia team

Talk page

  • Create a talk page for every article populated by migrated material.
  • Name the first section "Origin of page" and give links to original pages.
  • Create a new section for every distinct issue or query; new sections go at the bottom.
  • Add discussion text within migrated pages to the talk page with a "needs discussion" link on the main page.
  • Once the issue is resolved, strike through the text.

Archive

Migration

  • Add newly-migrated articles to List of cataloging pages migrated from Bard
  • Cataloging information is spread among several sources. Search these
    • Bard
    • pbworks
    • [file://\\nerissa\CentralLibrary\Cataloging\Cataloging%20website.html Old cataloging website]. Most of the pertinent information had been migrated to Bard, but there may be small oases of hidden information.
  • Refrain from doing any editing except for what is necessary to create and format the article. Add Advisory statements as appropriate
  • Once a page has been migrated, add a statement to the effect and a link to the Folgerpedia article.
This is an archived version of this article. For the most up-to-date version, see: [URL] 
Migrated to [URL]
  • If only a portion of a Bard or pbworks page is migrated, strike through the migrated text.
  • If none of the content of an existing Bard page is relevant (for example, pages made specifically for projects that have ended), do not migrate.