cocina-models 0.33.0 → 0.37.0

data/lib/cocina/models/file_access.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class FileAccess < Struct
+      # Access level
+      attribute :access, Types::Strict::String.default('dark').enum('world', 'stanford', 'location-based', 'citation-only', 'dark').meta(omittable: true)
+      # Available for controlled digital lending.
+      attribute :controlledDigitalLending, Types::Strict::Bool.meta(omittable: true)
+      # Download access level for a file
+      attribute :download, Types::Strict::String.default('none').enum('world', 'stanford', 'location-based', 'none').meta(omittable: true)
+      # If access is "location-based", which location should have access.
+      attribute :readLocation, Types::Strict::String.enum('spec', 'music', 'ars', 'art', 'hoover', 'm&m').meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/identification.rb

@@ -3,6 +3,8 @@
 module Cocina
   module Models
     class Identification < Struct
+      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation.
+
       # example: sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026
       attribute :sourceId, Types::Strict::String.meta(omittable: true)
       attribute :catalogLinks, Types::Strict::Array.of(CatalogLink).meta(omittable: true)

data/lib/cocina/models/language.rb

@@ -0,0 +1,30 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class Language < Struct
+      attribute :structuredValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :parallelValue, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      # String value of the descriptive element.
+      attribute :value, Types::Strict::String.meta(omittable: true)
+      # Type of value provided by the descriptive element.
+      attribute :type, Types::Strict::String.meta(omittable: true)
+      # Status of the descriptive element value relative to other instances of the element.
+      attribute :status, Types::Strict::String.meta(omittable: true)
+      # Code value of the descriptive element.
+      attribute :code, Types::Strict::String.meta(omittable: true)
+      # URI value of the descriptive element.
+      attribute :uri, Types::Strict::String.meta(omittable: true)
+      attribute :standard, Standard.optional.meta(omittable: true)
+      attribute :encoding, Standard.optional.meta(omittable: true)
+      attribute :source, Source.optional.meta(omittable: true)
+      # The preferred display label to use for the descriptive element in access systems.
+      attribute :displayLabel, Types::Strict::String.meta(omittable: true)
+      # A term providing information about the circumstances of the statement (e.g., approximate dates).
+      attribute :qualifier, Types::Strict::String.meta(omittable: true)
+      attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).meta(omittable: true)
+      attribute :script, DescriptiveValue.optional.meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/related_resource.rb

@@ -0,0 +1,21 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class RelatedResource < Struct
+      # The relationship of the related resource to the described resource.
+      attribute :type, Types::Strict::String.meta(omittable: true)
+      attribute :title, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :contributor, Types::Strict::Array.of(Contributor).meta(omittable: true)
+      attribute :event, Types::Strict::Array.of(Event).meta(omittable: true)
+      attribute :form, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :language, Types::Strict::Array.of(Language).meta(omittable: true)
+      attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :identifier, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :subject, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      # Stanford persistent URL associated with the related resource.
+      attribute :purl, Types::Strict::String.meta(omittable: true)
+      attribute :access, DescriptiveAccessMetadata.optional.meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/request_collection.rb

@@ -16,7 +16,7 @@ module Cocina
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
       attribute(:access, Access.default { Access.new })
-      attribute :administrative, Administrative.optional.meta(omittable: true)
+      attribute(:administrative, Administrative.default { Administrative.new })
       attribute :description, Description.optional.meta(omittable: true)
       attribute :identification, CollectionIdentification.optional.meta(omittable: true)
 

data/lib/cocina/models/request_dro.rb

@@ -26,7 +26,7 @@ module Cocina
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
       attribute :access, DROAccess.optional.meta(omittable: true)
-      attribute :administrative, Administrative.optional.meta(omittable: true)
+      attribute(:administrative, Administrative.default { Administrative.new })
       attribute :description, Description.optional.meta(omittable: true)
       attribute(:identification, RequestIdentification.default { RequestIdentification.new })
       attribute :structural, RequestDROStructural.optional.meta(omittable: true)

data/lib/cocina/models/request_file.rb

@@ -16,7 +16,7 @@ module Cocina
       attribute :externalIdentifier, Types::Strict::String.meta(omittable: true)
       attribute :use, Types::Strict::String.meta(omittable: true)
       attribute :hasMessageDigests, Types::Strict::Array.of(MessageDigest).default([].freeze)
-      attribute(:access, Access.default { Access.new })
+      attribute(:access, FileAccess.default { FileAccess.new })
       attribute(:administrative, FileAdministrative.default { FileAdministrative.new })
       attribute :presentation, Presentation.optional.meta(omittable: true)
     end

data/lib/cocina/models/request_identification.rb

@@ -3,6 +3,8 @@
 module Cocina
   module Models
     class RequestIdentification < Struct
+      # Unique identifier in some other system. This is because a large proportion of what is deposited in SDR, historically and currently, are representations of objects that are also represented in other systems. For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to look for the original item if you're looking at its SDR representation.
+
       # example: sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026
       attribute :sourceId, Types::Strict::String
       attribute :catalogLinks, Types::Strict::Array.of(CatalogLink).meta(omittable: true)

data/lib/cocina/models/source.rb

@@ -9,6 +9,7 @@ module Cocina
       attribute :uri, Types::Strict::String.meta(omittable: true)
       # String describing the value source.
       attribute :value, Types::Strict::String.meta(omittable: true)
+      attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
     end
   end
 end

data/lib/cocina/models/standard.rb

@@ -0,0 +1,16 @@
+# frozen_string_literal: true
+
+module Cocina
+  module Models
+    class Standard < Struct
+      # Code representing the standard or encoding.
+      attribute :code, Types::Strict::String.meta(omittable: true)
+      # URI for the standard or encoding.
+      attribute :uri, Types::Strict::String.meta(omittable: true)
+      # String describing the standard or encoding.
+      attribute :value, Types::Strict::String.meta(omittable: true)
+      attribute :note, Types::Strict::Array.of(DescriptiveValue).meta(omittable: true)
+      attribute :source, Source.optional.meta(omittable: true)
+    end
+  end
+end

data/lib/cocina/models/version.rb

@@ -2,6 +2,6 @@
 
 module Cocina
   module Models
-    VERSION = '0.33.0'
+    VERSION = '0.37.0'
   end
 end

data/openapi.yml

@@ -94,7 +94,7 @@ paths:
 components:
   schemas:
     Access:
-      description: Access metadata
+      description: Access metadata for collections
       type: object
       additionalProperties: false
       properties:
@@ -142,6 +142,8 @@ components:
           description: Administrative or Internal project this resource is a part of
           example: Google Books
           type: string
+      required:
+        - hasAdminPolicy
     AdminPolicy:
       type: object
       additionalProperties: false
@@ -162,11 +164,11 @@ components:
         description:
           $ref: '#/components/schemas/Description'
       required:
+        - administrative
         - externalIdentifier
         - label
         - type
         - version
-        - administrative
     AdminPolicyAdministrative:
       type: object
       additionalProperties: false
@@ -178,6 +180,8 @@ components:
           type: string
         hasAdminPolicy:
           type: string
+      required:
+        - hasAdminPolicy
     AppliesTo:
       description: Property model for indicating the parts, aspects, or versions of the resource to which a
         descriptive element is applicable.
@@ -250,7 +254,7 @@ components:
             $ref: '#/components/schemas/CatalogLink'
     Contributor:
       description: Property model for describing agents contributing in some way to
-        the creation and history of the resource
+        the creation and history of the resource.
       type: object
       additionalProperties: false
       properties:
@@ -263,7 +267,8 @@ components:
           description: Entity type of the contributor (person, organization, etc.).
           type: string
         status:
-          description: Status of the contributor relative to other parallel contributors.
+          description: Status of the contributor relative to other parallel contributors
+            (e.g. the primary author among a group of contributors).
           type: string
         role:
           description: Relationships of the contributor to the resource or to an event
@@ -271,90 +276,16 @@ components:
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
-    DescriptiveAdminMetadata:
-      description: Information about this description of the resource.
-      type: object
-      additionalProperties: false
-      properties:
-        contributor:
-          type: array
-          items:
-            $ref: "#/components/schemas/Contributor"
-        event:
-          type: array
-          items:
-            $ref: "#/components/schemas/Event"
-        language:
+        identifier:
+          description: Identifiers and URIs associated with the contributor entity.
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
         note:
+          description: Other information associated with the contributor.
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
-    DescriptiveBasicValue:
-      description: Value model for descriptive elements without recursive properties.
-      type: object
-      additionalProperties: false
-      properties:
-        value:
-          description: String value of the descriptive element.
-          type: string
-        type:
-          description: Type of value provided by the descriptive element.
-          type: string
-        status:
-          description: Status of the descriptive element relative to other instances
-            of the element.
-          type: string
-        code:
-          description: Code value of the descriptive element.
-          type: string
-        uri:
-          description: URI value of the descriptive element.
-          type: string
-          format: uri
-        standard:
-          description: Descriptive or content standard to which the value conforms.
-          type: array
-          items:
-            type: string
-        encoding:
-          description: Encoding schema, standard, or syntax to which the value conforms.
-          type: array
-          items:
-            type: string
-        source:
-          $ref: "#/components/schemas/Source"
-    DescriptiveStructuredValue:
-      description: Value model for descriptive elements structured as typed values.
-      type: object
-      additionalProperties: false
-      properties:
-        structuredValue:
-          type: array
-          items:
-            $ref: "#/components/schemas/DescriptiveBasicValue"
-    DescriptiveValue:
-      description: Default value model for descriptive elements.
-      type: object
-      additionalProperties: false
-      allOf:
-        - $ref: "#/components/schemas/DescriptiveBasicValue"
-        - $ref: "#/components/schemas/DescriptiveStructuredValue"
-        - $ref: "#/components/schemas/AppliesTo"
-    DescriptiveValueRequired:
-      type: object
-      additionalProperties: false
-      allOf:
-        - $ref: "#/components/schemas/DescriptiveValue"
-        - anyOf:
-            - type: object
-              required:
-                - value
-            - type: object
-              required:
-                - structuredValue
     Description:
       type: object
       additionalProperties: false
@@ -383,17 +314,23 @@ components:
           items:
             $ref: "#/components/schemas/DescriptiveValue"
         language:
-          description: Languages, scripts, and notations used in all or part of a resource.
+          description: Languages, scripts, symbolic systems, and notations used in all or
+            part of a resource.
           type: array
           items:
-            $ref: "#/components/schemas/DescriptiveValue"
+            $ref: "#/components/schemas/Language"
         note:
           description: Additional information relevant to a resource.
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
         identifier:
-          description: Unique strings associated with the resource.
+          description: Identifiers and URIs associated with the resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        subject:
+          description: Terms associated with the intellectual content of the resource.
           type: array
           items:
             $ref: "#/components/schemas/DescriptiveValue"
@@ -401,11 +338,13 @@ components:
           description: Stanford persistent URL associated with the resource.
           type: string
           format: uri
-        url:
-          description: URLs where the resource may be accessed in full or part.
+        access:
+          $ref: "#/components/schemas/DescriptiveAccessMetadata"
+        relatedResource:
+          description: Other resources associated with the described resource.
           type: array
           items:
-            $ref: "#/components/schemas/DescriptiveValue"
+            $ref: "#/components/schemas/RelatedResource"
         marcEncodedData:
           description: Data about the resource represented in MARC fixed fields and codes.
           type: array
@@ -415,6 +354,154 @@ components:
           $ref: "#/components/schemas/DescriptiveAdminMetadata"
       required:
         - title
+    DescriptiveAccessMetadata:
+      description: Information about how to access digital and physical versions of the object.
+      type: object
+      additionalProperties: false
+      properties:
+        url:
+          description: URLs where the resource may be accessed in full or part.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        physicalLocation:
+          description: Location of a physical version of the resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        accessContact:
+          description: The library, organization, or person responsible for access to the resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        digitalRepository:
+          description: The digital repositories that hold the resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        note:
+          description: Other information related to accessing the resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+    DescriptiveAdminMetadata:
+      description: Information about this resource description.
+      type: object
+      additionalProperties: false
+      properties:
+        contributor:
+          description: Contributors to this resource description.
+          type: array
+          items:
+            $ref: "#/components/schemas/Contributor"
+        event:
+          description: Events in the history of this resource description.
+          type: array
+          items:
+            $ref: "#/components/schemas/Event"
+        language:
+          description: Languages, scripts, symbolic systems, and notations used
+            in this resource description.
+          type: array
+          items:
+            $ref: "#/components/schemas/Language"
+        note:
+          description: Other information related to this resource description.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        standard:
+          # description: Descriptive or content standard to which this resource description conforms.
+          $ref: "#/components/schemas/Standard"
+        identifier:
+          description: Identifiers associated with this resource description.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+    DescriptiveBasicValue:
+      description: Basic value model for descriptive elements.
+      type: object
+      # additionalProperties breaks the validator, unclear as to why.
+      # additionalProperties: false
+      allOf:
+        - $ref: "#/components/schemas/DescriptiveStructuredValue"
+        - $ref: "#/components/schemas/DescriptiveParallelValue"
+        - type: object
+          additionalProperties: false
+          properties:
+            value:
+              description: String value of the descriptive element.
+              type: string
+            type:
+              description: Type of value provided by the descriptive element.
+              type: string
+            status:
+              description: Status of the descriptive element value relative to other instances
+                of the element.
+              type: string
+            code:
+              description: Code value of the descriptive element.
+              type: string
+            uri:
+              description: URI value of the descriptive element.
+              type: string
+              format: uri
+            standard:
+              # description: Descriptive or content standard to which the value conforms.
+              $ref: "#/components/schemas/Standard"
+            encoding:
+              # description: Encoding schema, standard, or syntax to which the value conforms.
+              $ref: "#/components/schemas/Standard"
+            source:
+              $ref: "#/components/schemas/Source"
+            displayLabel:
+              description: The preferred display label to use for the descriptive element in access systems.
+              type: string
+            qualifier:
+              description: A term providing information about the circumstances of the statement (e.g., approximate dates).
+              type: string
+            note:
+              description: Other information related to the descriptive element.
+              type: array
+              items:
+                $ref: "#/components/schemas/DescriptiveValue"
+    DescriptiveParallelValue:
+      description: Value model for multiple representations of the same information (e.g. in different languages).
+      type: object
+      additionalProperties: false
+      properties:
+        parallelValue:
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+    DescriptiveStructuredValue:
+      description: Value model for descriptive elements structured as typed, ordered values.
+      type: object
+      additionalProperties: false
+      properties:
+        structuredValue:
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+    DescriptiveValue:
+      description: Default value model for descriptive elements.
+      type: object
+      additionalProperties: false
+      allOf:
+        - $ref: "#/components/schemas/DescriptiveBasicValue"
+        - $ref: "#/components/schemas/AppliesTo"
+    DescriptiveValueRequired:
+      type: object
+      additionalProperties: false
+      allOf:
+        - $ref: "#/components/schemas/DescriptiveValue"
+        - anyOf:
+            - type: object
+              required:
+                - value
+            - type: object
+              required:
+                - structuredValue
     DRO:
       description: Domain-defined abstraction of a 'work'. Digital Repository Objects' abstraction is describable for our domain’s purposes, i.e. for management needs within our system.
       type: object
@@ -461,11 +548,12 @@ components:
         geographic:
           $ref: '#/components/schemas/Geographic'
       required:
+        - access
+        - administrative
         - externalIdentifier
         - label
         - type
         - version
-        - access
     DROAccess:
       type: object
       additionalProperties: false
@@ -479,6 +567,10 @@ components:
             - 'citation-only'
             - 'dark'
           default: 'dark'
+        controlledDigitalLending:
+          description: Available for controlled digital lending.
+          type: boolean
+          default: false
         copyright:
           description: The human readable copyright statement that applies
           example: Copyright World Trade Organization
@@ -633,7 +725,7 @@ components:
           items:
             $ref: '#/components/schemas/MessageDigest'
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/FileAccess'
         administrative:
           $ref: '#/components/schemas/FileAdministrative'
         presentation:
@@ -647,6 +739,44 @@ components:
         - access
         - administrative
         - hasMessageDigests
+    FileAccess:
+      description: Access metadata for files
+      type: object
+      additionalProperties: false
+      properties:
+        access:
+          description: Access level
+          type: string
+          enum:
+            - 'world'
+            - 'stanford'
+            - 'location-based'
+            - 'citation-only'
+            - 'dark'
+          default: 'dark'
+        controlledDigitalLending:
+          description: Available for controlled digital lending.
+          type: boolean
+          default: false
+        download:
+          description: Download access level for a file
+          type: string
+          enum:
+            - 'world'
+            - 'stanford'
+            - 'location-based'
+            - 'none'
+          default: 'none'
+        readLocation:
+          description: If access is "location-based", which location should have access.
+          type: string
+          enum:
+            - 'spec'
+            - 'music'
+            - 'ars'
+            - 'art'
+            - 'hoover'
+            - 'm&m'
     FileAdministrative:
       type: object
       additionalProperties: false
@@ -710,11 +840,34 @@ components:
       properties:
         sourceId:
           type: string
+          description: >
+            Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
+            historically and currently, are representations of objects that are also represented in other systems.
+            For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
+            in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
+            and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
+            look for the original item if you're looking at its SDR representation.
           example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
         catalogLinks:
           type: array
           items:
             $ref: '#/components/schemas/CatalogLink'
+    Language:
+      description: Languages, scripts, symbolic systems, and notations used in all
+        or part of a resource.
+      type: object
+      additionalProperties: false
+      allOf:
+        - $ref: '#/components/schemas/DescriptiveValue'
+        - type: object
+          # additionalProperties breaks the validator, presumably because it can't
+          # conform to other schemas (allOf) and not have additionalProperties
+          # additionalProperties: false
+          properties:
+            script:
+              $ref: '#/components/schemas/DescriptiveValue'
+              # description: An alphabet or other notation used to represent a
+              #   language or other symbolic system associated with the resource.
     MessageDigest:
       description: The output of the message digest algorithm.
       type: object
@@ -743,6 +896,63 @@ components:
         width:
           description: Width in pixels
           type: integer
+    RelatedResource:
+      description: Other resource associated with the described resource.
+      type: object
+      additionalProperties: false
+      properties:
+        type:
+          description: The relationship of the related resource to the described resource.
+          type: string
+        title:
+          description: Titles of the related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        contributor:
+          description: Agents contributing in some way to the creation and history of the
+            related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/Contributor"
+        event:
+          description: Events in the history of the related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/Event"
+        form:
+          description: Characteristics of the related resource's physical, digital, and intellectual
+            form and genre.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        language:
+          description: Languages, scripts, symbolic systems, and notations used in all or
+            part of a related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/Language"
+        note:
+          description: Additional information relevant to a related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        identifier:
+          description: Identifiers and URIs associated with the related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        subject:
+          description: Terms associated with the intellectual content of the related resource.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        purl:
+          description: Stanford persistent URL associated with the related resource.
+          type: string
+          format: uri
+        access:
+          $ref: "#/components/schemas/DescriptiveAccessMetadata"
     ReleaseTag:
       description: A tag that indicates the item or collection should be released.
       type: object
@@ -790,10 +1000,10 @@ components:
         description:
           $ref: '#/components/schemas/Description'
       required:
+        - administrative
         - label
         - type
         - version
-        - administrative
     RequestCollection:
       description: Same as a Collection, but doesn't have an externalIdentifier as one will be created
       type: object
@@ -821,10 +1031,11 @@ components:
         identification:
           $ref: '#/components/schemas/CollectionIdentification'
       required:
+        - access
+        - administrative
         - label
         - type
         - version
-        - access
     RequestDRO:
       description: A request to create a DRO.  This has the same general structure as a DRO but doesn't have externalIdentifier and doesn't require the access subschema. If no access subschema is provided, these values will be inherited from the AdminPolicy.
       type: object
@@ -866,10 +1077,11 @@ components:
         geographic:
           $ref: '#/components/schemas/Geographic'
       required:
+        - administrative
+        - identification
         - label
         - type
         - version
-        - identification
     RequestDROStructural:
       description: Structural metadata
       type: object
@@ -914,7 +1126,7 @@ components:
           items:
             $ref: '#/components/schemas/MessageDigest'
         access:
-          $ref: '#/components/schemas/Access'
+          $ref: '#/components/schemas/FileAccess'
         administrative:
           $ref: '#/components/schemas/FileAdministrative'
         presentation:
@@ -962,6 +1174,13 @@ components:
       properties:
         sourceId:
           type: string
+          description: >
+            Unique identifier in some other system. This is because a large proportion of what is deposited in SDR,
+            historically and currently, are representations of objects that are also represented in other systems.
+            For example, digitized paper and A/V collections have physical manifestations, and those physical objects are managed
+            in systems that have their own identifiers. Similarly, books have barcodes, archival materials have collection numbers
+            and physical locations, etc. The sourceId allows determining if an item has been deposited before and where to
+            look for the original item if you're looking at its SDR representation.
           example: 'sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026'
         catalogLinks:
           type: array
@@ -986,8 +1205,8 @@ components:
             - right-to-left
             - left-to-right
     Source:
-      description: Property model for indicating the vocabulary, authority, or other
-        origin for a term, code, or identifier.
+      description: Property model for indicating the vocabulary, authority, or
+        other origin for a term, code, or identifier.
       type: object
       additionalProperties: false
       properties:
@@ -1001,3 +1220,31 @@ components:
         value:
           description: String describing the value source.
           type: string
+        note:
+          description: Other information related to the value source.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+    Standard:
+      description: Property model for indicating the encoding, standard, or syntax
+        to which a value conforms.
+      type: object
+      additionalProperties: false
+      properties:
+        code:
+          description: Code representing the standard or encoding.
+          type: string
+        uri:
+          description: URI for the standard or encoding.
+          type: string
+          format: uri
+        value:
+          description: String describing the standard or encoding.
+          type: string
+        note:
+          description: Other information related to the standard or encoding.
+          type: array
+          items:
+            $ref: "#/components/schemas/DescriptiveValue"
+        source:
+          $ref: "#/components/schemas/Source"