Merge branch 'main' of https://github.com/NYPL/metadata-documentation

NYPL · Oct 31, 2024 · a0a1794 · a0a1794
2 parents b7e4c5f + 6540a99
commit a0a1794
Show file tree

Hide file tree

Showing 23 changed files with 47 additions and 58 deletions.
diff --git a/colophon/colophon.md b/colophon/colophon.md
@@ -7,12 +7,8 @@ has_children: true
 has_toc: false
 ---
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
 # About This Site
+{: .no_toc }
 
 ## Built With
 - [GitHub Pages](https://pages.github.com/)
@@ -21,6 +17,5 @@ has_toc: false
 
 ## Documentation Resources
 - [MSU Documentation Style Guide](/metadata-documentation/colophon/style-guide)
-- [Committing to Documentation › Writing Documentation
-](https://ctodocs.github.io/ctod/write-documentation.html)
+- [Committing to Documentation › Writing Documentation](https://ctodocs.github.io/ctod/write-documentation.html)
 - [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/)
diff --git a/colophon/style-guide.md b/colophon/style-guide.md
@@ -7,11 +7,6 @@ nav_exclude: true
 search_exclude: true
 ---
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
 # MSU Documentation Style Guide
 {: .no_toc }
 

diff --git a/contact/form.md → contact/form/form.md b/contact/form.md → contact/form/form.md
@@ -4,8 +4,9 @@ title: Contact Form
 permalink: /contact/form/
 parent: Contact
 nav_order: 1
+has_toc: false
 ---
 
 # Contact Form
 
-<iframe class="clickup-embed clickup-dynamic-height" src="https://forms.clickup.com/2305128/f/26b38-8327/PIBSUQLHJ5IX7ZDBU9" onwheel="" width="100%" height="100%" style="background: transparent; border: 0;"></iframe><script async src="https://app-cdn.clickup.com/assets/js/forms-embed/v1.js"></script>
+<iframe class="clickup-embed clickup-dynamic-height" src="https://forms.clickup.com/2305128/f/26b38-8327/PIBSUQLHJ5IX7ZDBU9" onwheel="" width="100%" height="100%" style="background: transparent; border: 0;"></iframe><script async src="https://app-cdn.clickup.com/assets/js/forms-embed/v1.js"></script>
diff --git a/metadata/division/berg.md b/metadata/division/berg.md
@@ -7,13 +7,13 @@ grand_parent: MMS › Metadata
 nav_exclude: true
 ---
 
+# Berg Collection
+{: .no_toc }
+
 {: .highlight-title }
 > 🚧 Under Construction
 >
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
-# Berg Collection
-{: .no_toc }
+> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
 
 ## Table of contents
 {: .no_toc .text-delta }

diff --git a/metadata/division/division.md b/metadata/division/division.md
@@ -7,12 +7,8 @@ nav_order: 7
 has_children: true
 ---
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
 # By Division
+{: .no_toc }
 
 These pages provide division-specific guidelines for record structure and the use of Metadata Object Description Schema (MODS) elements in the Metadata Management System (MMS)
 

diff --git a/metadata/division/manuscripts-archives.md b/metadata/division/manuscripts-archives.md
@@ -7,13 +7,13 @@ grand_parent: MMS › Metadata
 nav_exclude: true
 ---
 
+# Manuscripts and Archives Division
+{: .no_toc }
+
 {: .highlight-title }
 > 🚧 Under Construction
 >
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
-# Manuscripts and Archives Division
-{: .no_toc }
+> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
 
 ## Table of contents
 {: .no_toc .text-delta }

diff --git a/metadata/division/toft.md b/metadata/division/toft.md
@@ -69,4 +69,4 @@ Provides guidelines for metadata describing material from the Theatre on Film an
 ## See Also
 
 - [Theatre on Film and Tape Archive (Internal Documentation) 🔒](https://docs.google.com/document/d/1ukxv__9sH0-CkDDYB3zkmp3_xkTl4O1Ae5qk5YSQ_3Y/edit) for the respective [MSU Liason's 🔒](https://docs.google.com/spreadsheets/d/1P-YDJigon640fTCLP4Ig4-zmzqrX88v5M24ShuxFNVY/edit?gid=0) internal documentation and notes related to the Theatre on Film and Tape Archive
-- [MMS › Metadata › By Material › Audio and Moving Image (AMI)](/metadata-documentation/metadata/material/ami/) for guidelines for metadata specific to audio and moving image materials described in MMS
+- [MMS › Metadata › By Material › Audio & Moving Image (AMI)](/metadata-documentation/metadata/material/ami/) for guidelines for metadata specific to audio and moving image materials described in MMS
diff --git a/metadata/element/element.md b/metadata/element/element.md
@@ -9,6 +9,8 @@ has_toc: false
 ---
 
 # By Element
+{: .no_toc }
+
 These pages describe our local practices for each of the [Metadata Object Description Schema](/metadata-documentation/resources/glossary/#metadata-object-description-schema) (MODS) elements in the [Metadata Management System](/metadata-documentation/resources/glossary/#metadata-management-system) (MMS)
 
 {: .note }

diff --git a/metadata/element/identifier/ami-other.md b/metadata/element/identifier/ami-other.md
@@ -25,5 +25,5 @@ Free-text identifier field that can contain any value, used when adding an ident
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **AMI Other ID**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **AMI Other ID**
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **AMI Other ID**
 - [**SPEC Manual: Objects**](https://docs.google.com/document/d/1dP3zDqTT4uX_EsocFeUJ2VLgPMJechInvOzrcCtMsoU/edit), which describes "other legacy id" as one of the identifiers recorded and found in SPEC
diff --git a/metadata/element/identifier/ami-primary.md b/metadata/element/identifier/ami-primary.md
@@ -28,5 +28,5 @@ Unique identifier of an audio or moving image item assigned during inventory in
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **AMI Primary Identifier**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
 - [SPEC Manual: Objects](https://docs.google.com/document/d/1dP3zDqTT4uX_EsocFeUJ2VLgPMJechInvOzrcCtMsoU/edit), which describes "AMI ID" (or "CMS AMI ID") as one of the identifiers generated and found in SPEC
diff --git a/metadata/element/identifier/ami-project.md b/metadata/element/identifier/ami-project.md
@@ -25,5 +25,5 @@ Name of the project under which the media original was digitized
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **AMI Project**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **AMI Project**
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **AMI Project**
 - [**AMI Metadata Overview**](/ami-preservation/pages/ami-metadata.html) for documentation of metadata requirements and controlled vocabulary from the Library's Media Preservation units
diff --git a/metadata/element/identifier/ami.md b/metadata/element/identifier/ami.md
@@ -28,5 +28,5 @@ Unique identifier of an audio or moving image item assigned during inventory in
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **AMI Identifier**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
 - [SPEC Manual: Objects](https://docs.google.com/document/d/1dP3zDqTT4uX_EsocFeUJ2VLgPMJechInvOzrcCtMsoU/edit), which describes "AMI ID" (or "CMS AMI ID") as one of the identifiers generated and found in SPEC
diff --git a/metadata/element/identifier/barcode.md b/metadata/element/identifier/barcode.md
@@ -39,4 +39,4 @@ Unique identifier assigned to physical object
 - Do not set **Barcode**s added to collections or containers to be Inheritable
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including Barcode
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including Barcode
diff --git a/metadata/element/identifier/capture-original-filename.md b/metadata/element/identifier/capture-original-filename.md
@@ -25,5 +25,5 @@ Filename of the digitized asset
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **Capture Original Filename**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **Capture Original Filename**
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **Capture Original Filename**
 - [AMI Metadata Overview](https://nypl.github.io/ami-preservation/pages/ami-metadata.html) for documentation of metadata requirements and controlled vocabulary from the Library's Media Preservation units
diff --git a/metadata/element/identifier/cms-collection.md b/metadata/element/identifier/cms-collection.md
@@ -25,5 +25,5 @@ Identifier for the SPEC collection containing an item
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **CMS Collection Identifier**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **CMS Collection Identifier**
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for guidelines on the use of identifiers for AMI including **CMS Collection Identifier**
 - [**SPEC Manual: Objects**](https://docs.google.com/document/d/1dP3zDqTT4uX_EsocFeUJ2VLgPMJechInvOzrcCtMsoU/edit), which describes "AMI ID" (or "CMS AMI ID") as one of the identifiers generated and found in SPEC
diff --git a/metadata/element/identifier/cms.md b/metadata/element/identifier/cms.md
@@ -28,5 +28,5 @@ Unique identifier of an audio or moving image item assigned during inventory in
 - Ingest of AMI into MMS is currently paused, and thus there are not current guidelines for **CMS Identifier**, but legacy data may exist in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
+- [Audio & Moving Image (AMI) › Identifier](/metadata-documentation/metadata/material/ami/#identifier) for general guidelines on the use of identifiers for AMI
 - [SPEC Manual: Objects](https://docs.google.com/document/d/1dP3zDqTT4uX_EsocFeUJ2VLgPMJechInvOzrcCtMsoU/edit), which describes "AMI ID" (or "CMS AMI ID") as one of the identifiers generated and found in SPEC
diff --git a/metadata/material/ami.md b/metadata/material/ami.md
@@ -130,5 +130,5 @@ Provides guidelines for metadata specific to audio and moving image (AMI) materi
 
 ## See Also
 
-- [Audio and Moving Image (AMI)](/metadata-documentation/workflows/digitization/ami/) for guidelines pertaining to the ingest of AMI into MMS
+- [Audio & Moving Image (AMI)](/metadata-documentation/workflows/digitization/ami/) for guidelines pertaining to the ingest of AMI into MMS
 - [AMI Metadata Overview](https://nypl.github.io/ami-preservation/pages/ami-metadata.html) for documentation of metadata requirements and controlled vocabulary from the Library's Media Preservation units
diff --git a/projects/projects.md b/projects/projects.md
@@ -14,16 +14,16 @@ table th:nth-of-type(2) {
 }
 </style>
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
 # Projects
 {: .no_toc }
 
 An overview of projects initiated by or involving the Metadata Services Unit (MSU) and other collaborators throughout the Library
 
+{: .highlight-title }
+> 🚧 Under Construction
+>
+> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
+
 ## Table of contents
 {: .no_toc .text-delta }
 
@@ -105,7 +105,7 @@ Last updated October 2024
 
 | Dates | beginning June 2023 |
 | MSU Members | Emma C., Karly W., Sarah A.
-| Collaborators | Bob K. (Music Division), David L. (Photography Collection), Gina M. (Copyright and Information Policy), Samie K. (Audio and Moving Image Description), Stacey F. (Archival Processing) |
+| Collaborators | Bob K. (Music Division), David L. (Photography Collection), Samie K. (Audio and Moving Image Description), Stacey F. (Archival Processing), Gina M. (Copyright and Information Policy), Daniel A. (Special Projects Team) |
 | Related Links | [WikiProject](https://www.wikidata.org/wiki/Wikidata:WikiProject_New_York_Public_Library){: .btn } [Google Group 🔒](https://groups.google.com/a/nypl.org/g/wikidata){: .btn } [Slack 🔒](https://nyplpscp.slack.com/archives/C05C3EMCBL7){: .btn } |
 
 #### Overview

diff --git a/resources/glossary.md b/resources/glossary.md
@@ -394,6 +394,10 @@ Common terms used within the work of the Metadata Services Unit (MSU)
 <dt>MMS Database</dt>
 <dd><a href="#structured-query-language">SQL</a> database that powers the <a href="#metadata-management-system">Metadata Management System</a></dd>
 
+<a name="mms-qa"></a>
+<dt>MMS QA</dt>
+<dd>quality assurance version of the the <a href="#metadata-management-system">Metadata Management System</a> that functions as a non-production test environment; accessible at <a href="https://qa-metadata.nypl.org/">qa-metadata.nypl.org</a></dd>
+
 <a name="permissions-reproduction-services"></a>
 <dt>Permissions and Reproduction Services</dt>
 <dd>unit within <a href="#digital-collections-services">Digital Collections Services</a></dd>

diff --git a/workflows/digitization/ami.md b/workflows/digitization/ami.md
@@ -11,7 +11,7 @@ nav_exclude: true
 # Audio & Moving Image (AMI)
 {: .no_toc }
 
-Provides an overview of workflows pertaining to the ingest of Audio and Moving Image (AMI) into the Metadata Management System (MMS)
+Provides an overview of workflows pertaining to the ingest of audio and moving image (AMI) assets into the Metadata Management System (MMS)
 
 ## Table of contents
 {: .no_toc .text-delta }
@@ -36,4 +36,4 @@ Ingest of AMI into MMS is currently paused. The following legacy documents do no
         - Workflow for archival AMI collections that are ready for description in MMS
 
 ## See Also
-- [Audio and Moving Image (AMI)](/metadata-documentation/metadata/material/ami/) for guidelines on metadata elements for AMI
+- [Audio & Moving Image (AMI)](/metadata-documentation/metadata/material/ami/) for guidelines on metadata elements for AMI
diff --git a/workflows/digitization/digitization.md b/workflows/digitization/digitization.md
@@ -7,9 +7,7 @@ nav_order: 4
 has_children: true
 ---
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
+# Digitization
+{: .no_toc }
 
-# Digitization
+These pages describe workflows related to new digitization, particularly in relation to metadata creation in the Metadata Management System (MMS)
diff --git a/workflows/remediation/remediation.md b/workflows/remediation/remediation.md
@@ -7,9 +7,7 @@ nav_order: 5
 has_children: true
 ---
 
-{: .highlight-title }
-> 🚧 Under Construction
->
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
+# Remediation
+{: .no_toc }
 
-# Remediation
+These pages describe various workflows related to remediation of metadata records in the Metadata Management System (MMS)
diff --git a/workflows/troubleshooting.md b/workflows/troubleshooting.md
@@ -6,10 +6,10 @@ parent: MMS › Workflows
 nav_order: 9
 ---
 
+# Troubleshooting Issues
+{: .no_toc }
+
 {: .highlight-title }
 > 🚧 Under Construction
 >
-> This page is still being developed. Links to legacy documentation may appear to facilitate our migration process. [Contact us](/metadata-documentation/contact/) with any questions or feedback.
-
-# Troubleshooting Issues
-{: .no_toc }
+> This page is still being developed. [Contact us](/metadata-documentation/contact/) with any questions or feedback.