cocina-models 0.73.0 → 0.73.3

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b929b4e87bdb86010e2915c19628cb96dcafd101805e3c2dcee7ce56554d492f
-  data.tar.gz: 7aa988aa05b14e1e0521369ae1124acb0e4433195d7cd0011b239d63fa01b97b
+  metadata.gz: 57046023e6e82e42ba14eeaf854834fb7c58f1393f44cd8a45aef3830e2725fa
+  data.tar.gz: 5f756bf134c45dc0dd3bc0d1f27b7cb8bb1d1c69cb614160d8ee766ee442044e
 SHA512:
-  metadata.gz: a3ab493e7a4f41d48a1d583b695a6689bb5dac3117fd03d343c75ab7407a25df58755899b28a171fcdc3425a6a204582a4f112f31e51d70ef3ac766bd27d4107
-  data.tar.gz: 45f9b2c0d9fd7b9e9d542f12d20e90ef0aacf536fa6477f691888e8a60dfcef96efce4a5c62793f8cd7eb7e27c30286360e036413bc975ff5bf316b271adf40f
+  metadata.gz: 5516df72a6cbfd795b460e19e8f3b54db34aadbf35a6b3c3da400da8751657782e37babadcf4c06f0ee02158ed0e4b82998f969a5a3b0d2b4b1f729683ee38fc
+  data.tar.gz: 50bf4417aaaa1e5190fe239c68f83b75666295d914ec6c829ef3f703586a47b22046da53effa40b44daeb03d123358d3ed6e7da4dbbcd68f74b4e7c22402c475

data/README.md

@@ -31,6 +31,11 @@ exe/generator generate_schema DRO
 exe/generator generate_vocab
 ```
 
+### Descriptive documentation
+```
+exe/generator generate_descriptive_docs
+```
+
 ## Testing
 
 The generator is tested via its output when run against `openapi.yml`, viz., the Cocina model classes. Thus, `generate` should be run after any changes to `openapi.yml`.

data/description_types.yml

@@ -148,6 +148,7 @@ event.date:
     description: The addition of a resource to a set of other resources.
   - value: copyright
     description: The activity by which a resource may be considered subject to copyright law.
+  - value: coverage
   - value: creation
     description: The coming into being of a resource.
   - value: degree conferral
@@ -200,7 +201,7 @@ event.note:
 form:
   - value: carrier
   - value: data format
-  - value: digital original
+  - value: digital origin
   - value: extent
   - value: form
   - value: genre
@@ -213,45 +214,6 @@ form:
   - value: resource type
   - value: technique
   - value: type
-form.note:
-  - value: additions
-  - value: arrangement
-  - value: binding
-  - value: codicology
-  - value: collation
-  - value: colophon
-  - value: condition
-  - value: decoNote
-    status: deprecated
-    use: decoration
-  - value: decoration
-  - value: dimensions
-  - value: explicit
-  - value: foliation
-  - value: genre type
-  - value: hand note
-  - value: handNote
-    status: deprecated
-    use: hand note
-  - value: incipit
-  - value: instrumentation
-  - value: layout
-  - value: material
-  - value: medium of performance
-  - value: provenance
-  - value: reassembly
-  - value: reproduction
-  - value: research
-  - value: rubric
-  - value: secfol
-    status: deprecated
-    use: second folio
-  - value: second folio
-  - value: secondFolio
-    status: deprecated
-    use: second folio
-  - value: unit
-  - value: writing
 form.structuredValue:
   - value: type
   - value: subtype
@@ -281,6 +243,8 @@ identifier:
     code: arxiv
   - value: case identifier
   - value: case number
+  - value: CSt
+  - value: CStRLIN
   - value: document number
   - value: DOI
     code: doi
@@ -314,6 +278,7 @@ identifier:
   - value: music publisher
     code: music-publisher
   - value: OCLC
+  - value: OCoLC
   - value: PMCID
   - value: PMID
   - value: record id
@@ -326,6 +291,7 @@ identifier:
     use: Source ID
   - value: stock number
     code: stock-number
+  - value: SUL catalog key
   - value: Swets (Netherlands) ID
     code: swets
   - value: UPC
@@ -351,8 +317,10 @@ note:
   - value: additions
   - value: admin
   - value: affiliation
+  - value: arrangement
   - value: bibliographic
   - value: bibliography
+  - value: binding
   - value: biographical/historical
   - value: biographical/historical note
     status: deprecated
@@ -360,6 +328,10 @@ note:
   - value: biography
   - value: boat note
   - value: citation/reference
+  - value: codicology
+  - value: collation
+  - value: colophon
+  - value: condition
   - value: contact
   - value: content
   - value: content note
@@ -373,19 +345,34 @@ note:
   - value: creation/production credits
   - value: date
   - value: date/sequential designation
+  - value: decoNote
+    status: deprecated
+    use: decoration
+  - value: decoration
   - value: description
   - value: digitization
+  - value: dimensions
   - value: duration
   - value: event
   - value: exhibitions
+  - value: explicit
+  - value: foliation
   - value: funding
   - value: general
   - value: genre type
   - value: geography
+  - value: hand note
+  - value: handNote
+    status: deprecated
+    use: hand note
   - value: host
+  - value: incipit
+  - value: instrumentation
   - value: language
+  - value: layout
   - value: local
   - value: location
+  - value: material
   - value: medium of performance
   - value: names
   - value: numbering
@@ -403,11 +390,20 @@ note:
   - value: reassembly
   - value: reference
   - value: references
+  - value: reformatting
   - value: related publication
   - value: reproduction
   - value: research
   - value: restriction
+  - value: rubric
   - value: scope and content
+  - value: secfol
+    status: deprecated
+    use: second folio
+  - value: second folio
+  - value: secondFolio
+    status: deprecated
+    use: second folio
   - value: source characteristics
   - value: source identifier
   - value: statement of responsibility
@@ -420,6 +416,7 @@ note:
   - value: thesis
   - value: transcript
   - value: translation
+  - value: unit
   - value: update
   - value: use and reproduction
   - value: venue
@@ -484,14 +481,22 @@ subject.note:
   - value: role
 subject.structuredValue:
   - value: activity dates
+  - value: area
   - value: city
+  - value: city section
+  - value: conference
   - value: continent
   - value: country
+  - value: county
   - value: end
   - value: east
+  - value: event
+  - value: extraterrestrial area
   - value: display
+  - value: family
   - value: forename
   - value: genre
+  - value: island
   - value: latitude
   - value: life dates
   - value: longitude
@@ -500,18 +505,24 @@ subject.structuredValue:
   - value: north
   - value: occupation
   - value: ordinal
+  - value: organization
   - value: part name
+  - value: part number
   - value: person
   - value: place
+  - value: region
   - value: south
   - value: start
+  - value: state
   - value: surname
   - value: term of address
+  - value: territory
   - value: time
   - value: title
   - value: topic
   - value: west
 subject.structuredValue.note:
+  - value: affiliation
   - value: role
     description: The relation of the subject entity to the resource.
 subject.groupedValue:

data/docs/_config.yml

@@ -0,0 +1 @@
+theme: jekyll-theme-tactile

data/docs/description_types.md

@@ -0,0 +1,461 @@
+# Description types
+
+## Access accesscontact types
+_Path: access.accessContact_
+  * email: Email address for a contact person or institution concerning the resource.
+  * repository: Institution providing access to the resource.
+
+## Access digitallocation types
+_Path: access.digitalLocation_
+  * discovery: Online location for the purpose of discovering the resource.
+
+## Access note types
+_Path: access.note_
+  * access restriction: Restrictions on or conditions for gaining access to the resource.
+  * display label: Display label for the purl.
+  * license: License describing allowed uses of the resource.
+  * use and reproduction: Information related to allowed uses of the resource in other contexts.
+
+## Access physicallocation types
+_Path: access.physicalLocation_
+  * discovery: Location where a user may find the resource.
+  * location: Physical location of the resource, or path to the resource on a hard drive or disk.
+  * repository: The institution holding the resource.
+  * series: Archival series of the resource.
+  * shelf locator: Identifier or shelfmark indicating the location of the resource.
+
+## Adminmetadata note types
+_Path: adminMetadata.note_
+  * record information: General information about the metadata record.
+  * record origin: The source of the record, such as another record transformed to generate the current record.
+
+# Contributor types
+_Path: contributor_
+  * conference: An event focusing on a particular topic or discipline.
+  * event: A time-bound occurrence.
+  * family: A group of individuals related by blood or personal alliance.
+  * organization: An institution or other corporate or collective body.
+  * person: An individual identity.
+  * unspecified others: Designator for one or more additional contributors not named individually.
+
+## Contributor identifier types
+_Path: contributor.identifier_
+  * ORCID: Identifier from orcid.org.
+  * Wikidata: Identifier from wikidata.org.
+
+## Contributor name types
+_Path: contributor.name_
+  * alternative: Additional nonpreferred form of name.
+  * display: Preferred form of the name for display.
+  * forename: First or given name or names.
+  * inverted full name: Name given in last name, first name order.
+  * pseudonym: Name used that differs from legal or primary form of name.
+  * surname: Last or family name.
+  * transliteration: Name originally in non-Latin script presented phonetically using Latin characters.
+
+### Contributor name part types for structured value
+_Path: contributor.name.structuredValue_
+  * activity dates: The date or dates when someone was producing work.
+  * forename: First or given name or names.
+  * life dates: Birth and death dates, or dates when an entity was in existence.
+  * name: Name provided alongside additional information.
+  * ordinal: Indicator that the name is one in a series (e.g. Elizabeth I, Martin Luther King, Jr.).
+  * surname: Last or family name.
+  * term of address: Title or other signifier associated with name.
+
+### Contributor name types for grouped value (MODS legacy)
+_Path: contributor.name.groupedValue_
+  * alternative: Additional nonpreferred form of name.
+  * name: Primary form of name within group of values.
+  * pseudonym: Name used that differs from legal or primary form of name.
+
+## Contributor note types
+_Path: contributor.note_
+  * affiliation: Institution with which the contributor is associated.
+  * citation status: Indicator of whether the contributor should be included in the citation.
+  * description: Biographical information about the contributor.
+
+# Event types
+_Path: event_
+  * acquisition: The transferral of ownership of a resource to a repository.
+  * capture: A record of the resource in a fixed form at a specific time.
+  * collection: The addition of a resource to a set of other resources.
+  * copyright: The activity by which a resource may be considered subject to copyright law.
+  * copyright notice: An explicit statement that a resource is under copyright.
+  * creation: The coming into being of a resource.
+  * degree conferral: The institutional approval of a thesis or other resource leading to an academic degree.
+  * development: The creation of a print from a photographic negative or other source medium.
+  * distribution: The delivery of the resource to an external audience.
+  * generation: The creation of a resource by an automatic or natural process.
+  * manufacture: The physical assembly of a resource, often in multiple copies, for publication or other distribution.
+  * modification: A change to an existing resource.
+  * performance: The enactment of an artistic or cultural work for an audience, such as a play.
+  * presentation: The discussion of an academic or intellectual work for an audience, such as a seminar.
+  * production: The physical assembly of a resource not considered published, such as page proofs for a book.
+  * publication: The publishing or issuing of a resource.
+  * recording: The initial fixation to a medium of live audio and/or visual activity.
+  * release: Making a resource available to a broader audience.
+  * submission: The provision of a resource for review or evaluation.
+  * validity: When a resource takes effect, such as a revised train schedule.
+  * withdrawal: The removal of previous access to a resource, often due to its obsolescence.
+
+## Event date types
+_Path: event.date_
+  * acquisition: The transferral of ownership of a resource to a repository.
+  * capture: A record of the resource in a fixed form at a specific time.
+  * collection: The addition of a resource to a set of other resources.
+  * copyright: The activity by which a resource may be considered subject to copyright law.
+  * coverage
+  * creation: The coming into being of a resource.
+  * degree conferral: The institutional approval of a thesis or other resource leading to an academic degree.
+  * developed: The creation of a print from a photographic negative or other source medium.
+  * development: The creation of a print from a photographic negative or other source medium.
+  * distribution: The delivery of the resource to an external audience.
+  * generation: The creation of a resource by an automatic or natural process.
+  * manufacture: The physical assembly of a resource, often in multiple copies, for publication or other distribution.
+  * modification: A change to an existing resource.
+  * performance: The enactment of an artistic or cultural work for an audience, such as a play.
+  * presentation: The discussion of an academic or intellectual work for an audience, such as a seminar.
+  * production: The physical assembly of a resource not considered published, such as page proofs for a book.
+  * publication: The publishing or issuing of a resource.
+  * recording: The initial fixation to a medium of live audio and/or visual activity.
+  * release: Making a resource available to a broader audience.
+  * submission: The provision of a resource for review or evaluation.
+  * validity: When a resource takes effect, such as a revised train schedule.
+  * withdrawal: The removal of previous access to a resource, often due to its obsolescence.
+
+### Event date part types for structured value
+_Path: event.date.structuredValue_
+  * start: The start date in a range.
+  * end: The end date in a range.
+
+## Event note types
+_Path: event.note_
+  * copyright statement: A formal declaration of copyright on a resource.
+  * edition
+  * frequency: How often a resource is issued, such as monthly.
+  * issuance: How the resource is issued, such as serially.
+
+# Form types
+_Path: form_
+  * carrier
+  * data format
+  * digital origin
+  * extent
+  * form
+  * genre
+  * map projection
+  * map scale
+  * material
+  * media
+  * media type
+  * reformatting quality
+  * resource type
+  * technique
+  * type
+
+## Form part types for structured value
+_Path: form.structuredValue_
+  * type
+  * subtype
+
+## Geographic form types
+_Path: geographic.form_
+  * data format
+  * media type
+  * type
+
+## Geographic subject types
+_Path: geographic.subject_
+  * bounding box coordinates
+  * coverage
+  * point coordinates
+
+### Geographic subject part types for structured value
+_Path: geographic.subject.structuredValue_
+  * east
+  * latitude
+  * longitude
+  * north
+  * south
+  * west
+
+# Identifier types
+_Path: identifier_
+  * accession number
+  * alternate case number
+  * Apis ID
+  * ARK
+  * arXiv
+  * case identifier
+  * case number
+  * CSt
+  * CStRLIN
+  * document number
+  * DOI
+  * druid
+  * GTIN-14 ID
+  * Handle
+  * inventory number
+  * ISBN
+  * ISMN
+  * ISRC
+  * ISSN
+  * ISSN-L
+  * issue number
+  * LCCN
+  * local
+  * Local ID
+  * matrix number
+  * music plate
+  * music publisher
+  * OCLC
+  * OCoLC
+  * PMCID
+  * PMID
+  * record id
+  * Senate Number
+  * Series
+  * SIRSI
+  * Source ID
+  * sourceID
+  * stock number
+  * SUL catalog key
+  * Swets (Netherlands) ID
+  * UPC
+  * URI
+  * URN
+  * videorecording identifier
+  * West Mat \#
+  * Wikidata
+
+# Note types
+_Path: note_
+  * abstract
+  * access
+  * access note
+  * acquisition
+  * action
+  * additional physical form
+  * additions
+  * admin
+  * affiliation
+  * arrangement
+  * bibliographic
+  * bibliography
+  * binding
+  * biographical/historical
+  * biographical/historical note
+  * biography
+  * boat note
+  * citation/reference
+  * codicology
+  * collation
+  * colophon
+  * condition
+  * contact
+  * content
+  * content note
+  * content warning
+  * contents
+  * copyright
+  * creation/production credits
+  * date
+  * date/sequential designation
+  * decoNote
+  * decoration
+  * description
+  * digitization
+  * dimensions
+  * duration
+  * event
+  * exhibitions
+  * explicit
+  * foliation
+  * funding
+  * general
+  * genre type
+  * geography
+  * hand note
+  * handNote
+  * host
+  * incipit
+  * instrumentation
+  * language
+  * layout
+  * local
+  * location
+  * material
+  * medium of performance
+  * names
+  * numbering
+  * original location
+  * other relation type
+  * ownership
+  * part
+  * performer
+  * performers
+  * preferred citation
+  * provenance
+  * publications
+  * qualifications
+  * quote
+  * reassembly
+  * reference
+  * references
+  * reformatting
+  * related publication
+  * reproduction
+  * research
+  * restriction
+  * rubric
+  * scope and content
+  * secfol
+  * second folio
+  * secondFolio
+  * source characteristics
+  * source identifier
+  * statement of responsibility
+  * summary
+  * system details
+  * system requirements
+  * table of contents
+  * target audience
+  * technical note
+  * thesis
+  * transcript
+  * translation
+  * unit
+  * update
+  * use and reproduction
+  * venue
+  * version
+  * version identification
+  * writing
+
+## Note types for grouped value (MODS legacy)
+_Path: note.groupedValue_
+  * caption
+  * date
+  * detail type
+  * extent unit
+  * list
+  * marker
+  * number
+  * title
+  * text
+
+# Relatedresource types
+_Path: relatedResource_
+  * has original version: An initial form of the resource.
+  * has other format: A version of the resource in a different physical or digital format.
+  * has part: A constituent unit of the resource.
+  * has version: A version of the resource with different intellectual content.
+  * in series: The name of a series of publications to which the resource belongs.
+  * other relation type: Resource type not otherwise described.
+  * part of: A larger resource to which the resource belongs, such as a collection.
+  * preceded by: A predecessor to the resource, such as a preceding journal title.
+  * referenced by: Other resources that cite the resource, such as a catalog.
+  * references: A resource which the resource references or cites.
+  * related to: A generically related resource.
+  * reviewed by: A review of the resource.
+  * succeeded by: A successor to the resource, such as a subsequent journal title.
+
+# Subject types
+_Path: subject_
+  * classification
+  * conference
+  * display
+  * event
+  * family
+  * genre
+  * map coordinates
+  * name
+  * occupation
+  * organization
+  * person
+  * place
+  * point coordinates
+  * time
+  * title
+  * topic
+
+## Subject note types
+_Path: subject.note_
+  * role
+
+## Subject part types for structured value
+_Path: subject.structuredValue_
+  * activity dates
+  * area
+  * city
+  * city section
+  * conference
+  * continent
+  * country
+  * county
+  * end
+  * east
+  * event
+  * extraterrestrial area
+  * display
+  * family
+  * forename
+  * genre
+  * island
+  * latitude
+  * life dates
+  * longitude
+  * main title
+  * name
+  * north
+  * occupation
+  * ordinal
+  * organization
+  * part name
+  * part number
+  * person
+  * place
+  * region
+  * south
+  * start
+  * state
+  * surname
+  * term of address
+  * territory
+  * time
+  * title
+  * topic
+  * west
+
+### Subject note types
+_Path: subject.structuredValue.note_
+  * affiliation
+  * role: The relation of the subject entity to the resource.
+
+## Subject types for grouped value (MODS legacy)
+_Path: subject.groupedValue_
+  * uniform: Form of title in Library of Congress title authority.
+
+# Title types
+_Path: title_
+  * abbreviated: Abbreviated form of title for indexing or identification.
+  * alternative: Variant title.
+  * parallel: Title transcribed from the resource in multiple languages or scripts.
+  * supplied: Title provided by metadata creator rather than transcribed from the resource.
+  * translated: Title translated into another language.
+  * transliterated: Title transliterated from non-Latin script to Latin script.
+  * uniform: Form of title in Library of Congress title authority.
+
+## Title note types
+_Path: title.note_
+  * associated name: A name linked to the title, such as for a name-title heading.
+  * nonsorting character count: The number of characters at the beginning of the string to be disregarded when sorting.
+
+## Title part types for structured value
+_Path: title.structuredValue_
+  * main title: The primary part of a multipart title.
+  * nonsorting characters: A string at the beginning of the title to be disregarded when sorting.
+  * part name: The distinct name of a resource as part of a series or multivolume set.
+  * part number: The distinct number of a resource as part of a series or multivolume set.
+  * subtitle: The secondary part of a title.

data/lib/cocina/generator/generator.rb

@@ -28,6 +28,7 @@ module Cocina
         # rubocop:enable Style/HashEachMethods
 
         generate_vocab
+        generate_descriptive_docs
       end
 
       desc 'generate_schema SCHEMA_NAME', 'generate for SCHEMA_NAME'
@@ -45,8 +46,56 @@ module Cocina
         Vocab.generate(schemas, output_dir: options[:output])
       end
 
+      desc 'generate_descriptive_docs', 'generate descriptive documentation'
+      def generate_descriptive_docs
+        markdown = YAML.load_file('description_types.yml').map do |field, types|
+          header_markdown = field_markdown_from(field)
+          types_markdown = types_markdown_from(types)
+
+          <<~MARKDOWN
+            #{'#' * (field.count('.') + 1)} #{header_markdown}
+            _Path: #{field}_
+            #{types_markdown}
+          MARKDOWN
+        end.join("\n")
+
+        remove_file 'docs/description_types.md'
+        create_file 'docs/description_types.md', h1_markdown + markdown
+      end
+
       private
 
+      def h1_markdown
+        <<~MARKDOWN
+          # Description types
+
+        MARKDOWN
+      end
+
+      def field_markdown_from(field)
+        header = field.split('.')
+                      .grep_v(/groupedValue|structuredValue/)
+                      .join(' ')
+                      .capitalize
+
+        header_suffix = if field.ends_with?('structuredValue')
+                          'part types for structured value'
+                        elsif field.ends_with?('groupedValue')
+                          'types for grouped value (MODS legacy)'
+                        else
+                          'types'
+                        end
+        "#{header} #{header_suffix}"
+      end
+
+      def types_markdown_from(types)
+        types.map do |type|
+          "  * #{type['value']}".tap do |type_value|
+            type_value << ": #{type['description']}" if type['description']
+          end
+        end.join("\n")
+      end
+
       def schemas
         @schemas ||= Openapi3Parser.load_file(options[:openapi]).components.schemas
       end

data/lib/cocina/models/validators/description_types_validator.rb

@@ -11,7 +11,7 @@ module Cocina
 
         def initialize(clazz, attributes)
           @clazz = clazz
-          @attributes = attributes
+          @attributes = attributes.deep_symbolize_keys
           @error_paths = []
         end
 
@@ -60,7 +60,7 @@ module Cocina
             next unless match?(path, type_signature)
             break if types.include?(type.downcase)
 
-            error_paths << path_to_s(path)
+            error_paths << "#{path_to_s(path)} (#{type})"
             break
           end
         end
@@ -72,7 +72,7 @@ module Cocina
         # Some part of the path are ignored for the purpose of matching.
         def clean_path(path)
           new_path = path.reject do |part|
-            part.is_a?(Integer) || part == :parallelValue
+            part.is_a?(Integer) || %i[parallelValue parallelContributor parallelEvent].include?(part)
           end
           # This needs to happen after parallelValue is removed
           # to handle structuredValue > parallelValue > structuredValue

data/lib/cocina/models/version.rb

@@ -2,6 +2,6 @@
 
 module Cocina
   module Models
-    VERSION = '0.73.0'
+    VERSION = '0.73.3'
   end
 end

data/openapi.yml

@@ -523,7 +523,7 @@ components:
           items:
             $ref: "#/components/schemas/DescriptiveValue"
         type:
-          description: Entity type of the contributor (person, organization, etc.).
+          description: Entity type of the contributor (person, organization, etc.). See https://sul-dlss.github.io/cocina-models/description_types.html for valid types.
           type: string
         status:
           description: Status of the contributor relative to other parallel contributors
@@ -712,7 +712,7 @@ components:
               # https://github.com/interagent/committee/issues/286
               # - type: integer
             type:
-              description: Type of value provided by the descriptive element.
+              description: Type of value provided by the descriptive element. See https://sul-dlss.github.io/cocina-models/description_types.html for valid types.
               type: string
             status:
               description: Status of the descriptive element value relative to other instances
@@ -788,7 +788,7 @@ components:
           items:
             $ref: "#/components/schemas/DescriptiveValue"
         type:
-          description: Entity type of the contributor (person, organization, etc.).
+          description: Entity type of the contributor (person, organization, etc.). See https://sul-dlss.github.io/cocina-models/description_types.html for valid types.
           type: string
         status:
           description: Status of the contributor relative to other parallel contributors (e.g. the primary author among a group of contributors).

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: cocina-models
 version: !ruby/object:Gem::Version
-  version: 0.73.0
+  version: 0.73.3
 platform: ruby
 authors:
 - Justin Coyne
 autorequire:
 bindir: exe
 cert_chain: []
-date: 2022-04-12 00:00:00.000000000 Z
+date: 2022-04-14 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: activesupport
@@ -275,7 +275,9 @@ files:
 - bin/setup
 - cocina-models.gemspec
 - description_types.yml
+- docs/_config.yml
 - docs/cocina-base.jsonld
+- docs/description_types.md
 - docs/index.html
 - docs/maps/Agent.json
 - docs/maps/Collection.json