cocina-models 0.107.0 → 0.108.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 5274bff6327cebe2e04f7cc145fde055203131ae9885b4f654ff83dbbbe57408
-  data.tar.gz: 2cf28892860fdf3eb011a54aaaf4f6a25663f85cf66b8a1b15280b4165fe52f3
+  metadata.gz: dd16339f9a675493e71e0ced334d9f5c265dd0ce0c712f7016f8fd0e4e5c4125
+  data.tar.gz: 03f80e5b956fd69a8dbf978469668f62bac2c70a9100f781d05d4c3d7f662f92
 SHA512:
-  metadata.gz: 46b42f34df5bf8aba16f2d47110f8d81ae5f1be62b0b5aeda6fba9898b911540788a6f9ff23318cc7e0870a6c57a8dc95a14b50ced333628ef6f703fd842872f
-  data.tar.gz: a769621283a3433cebb98fff0e3a872f21016050e38770932af0aafc1634993631d31e50bddc58cc0720c6002fcaa9ae48fac840aa6042f39d55a745c6a7ec0b
+  metadata.gz: c0f258871c023833f9d43443c2140e091671d18d1f4c65c12626e14308ee78c99baa91fdb2a408b88d0ad3f7197931ddfb57979b122c806eec664e1b15a6fdff
+  data.tar.gz: 8f5d5d83bbf5c0ed0a919056458b7ac13bf009f537f69fbf60c8220acdcf14adeb594a5ff0c601da87859cae23e85fea7fd49b2d0368d500c1530bcdf041a629

data/.rubocop.yml

@@ -538,3 +538,5 @@ Style/EmptyStringInsideInterpolation: # new in 1.76
   Enabled: true
 Style/RedundantArrayFlatten: # new in 1.76
   Enabled: true
+Style/ArrayIntersectWithSingleElement: # new in 1.81
+  Enabled: true

data/Gemfile

@@ -5,5 +5,5 @@ source 'https://rubygems.org'
 # Specify your gem's dependencies in cocina-models.gemspec
 gemspec
 
-gem 'byebug'
+gem 'debug'
 gem 'rspec_junit_formatter' # For CircleCI

data/Gemfile.lock

@@ -1,7 +1,7 @@
 PATH
   remote: .
   specs:
-    cocina-models (0.107.0)
+    cocina-models (0.108.0)
       activesupport
       deprecation
       dry-struct (~> 1.0)
@@ -19,14 +19,14 @@ PATH
 GEM
   remote: https://rubygems.org/
   specs:
-    activesupport (8.0.3)
+    activesupport (8.1.0)
       base64
-      benchmark (>= 0.3)
       bigdecimal
       concurrent-ruby (~> 1.0, >= 1.3.1)
       connection_pool (>= 2.2.5)
       drb
       i18n (>= 1.6, < 2)
+      json
       logger (>= 1.4.2)
       minitest (>= 5.1)
       securerandom (>= 0.3)
@@ -35,15 +35,17 @@ GEM
     ast (2.4.3)
     attr_extras (7.1.0)
     base64 (0.3.0)
-    benchmark (0.4.1)
-    bigdecimal (3.2.3)
-    byebug (12.0.0)
+    bigdecimal (3.3.1)
     committee (5.0.0)
       json_schema (~> 0.14, >= 0.14.3)
       openapi_parser (~> 1.0)
       rack (>= 1.5)
     concurrent-ruby (1.3.5)
     connection_pool (2.5.4)
+    date (3.4.1)
+    debug (1.11.0)
+      irb (~> 1.10)
+      reline (>= 0.3.8)
     deprecation (1.1.0)
       activesupport
     diff-lcs (1.6.2)
@@ -75,10 +77,16 @@ GEM
       activesupport (>= 3.0, < 9.0)
     equivalent-xml (0.6.0)
       nokogiri (>= 1.4.3)
+    erb (5.1.1)
     i18n (1.14.7)
       concurrent-ruby (~> 1.0)
     ice_nine (0.11.2)
-    json (2.15.0)
+    io-console (0.8.1)
+    irb (1.15.2)
+      pp (>= 0.6.0)
+      rdoc (>= 4.0.0)
+      reline (>= 0.4.2)
+    json (2.15.2)
     json_schema (0.21.0)
     jsonpath (1.1.5)
       multi_json
@@ -86,7 +94,7 @@ GEM
     lint_roller (1.1.0)
     logger (1.7.0)
     mini_portile2 (2.8.9)
-    minitest (5.25.5)
+    minitest (5.26.0)
     multi_json (1.17.0)
     nokogiri (1.18.10)
       mini_portile2 (~> 2.8.2)
@@ -94,33 +102,45 @@ GEM
     openapi_parser (1.0.0)
     optimist (3.2.1)
     parallel (1.27.0)
-    parser (3.3.9.0)
+    parser (3.3.10.0)
       ast (~> 2.4.1)
       racc
     patience_diff (1.2.0)
       optimist (~> 3.0)
-    prism (1.5.1)
+    pp (0.6.3)
+      prettyprint
+    prettyprint (0.2.0)
+    prism (1.6.0)
+    psych (5.2.6)
+      date
+      stringio
     racc (1.8.1)
-    rack (3.2.1)
+    rack (3.2.3)
     rainbow (3.1.1)
     rake (13.3.0)
+    rdoc (6.15.0)
+      erb
+      psych (>= 4.0.0)
+      tsort
     regexp_parser (2.11.3)
-    rspec (3.13.1)
+    reline (0.6.2)
+      io-console (~> 0.5)
+    rspec (3.13.2)
       rspec-core (~> 3.13.0)
       rspec-expectations (~> 3.13.0)
       rspec-mocks (~> 3.13.0)
-    rspec-core (3.13.5)
+    rspec-core (3.13.6)
       rspec-support (~> 3.13.0)
     rspec-expectations (3.13.5)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
-    rspec-mocks (3.13.5)
+    rspec-mocks (3.13.6)
       diff-lcs (>= 1.2.0, < 2.0)
       rspec-support (~> 3.13.0)
     rspec-support (3.13.6)
     rspec_junit_formatter (0.6.0)
       rspec-core (>= 2, < 4, != 2.12.0)
-    rubocop (1.81.1)
+    rubocop (1.81.6)
       json (~> 2.3)
       language_server-protocol (~> 3.17.0.2)
       lint_roller (~> 1.1.0)
@@ -148,17 +168,19 @@ GEM
       simplecov_json_formatter (~> 0.1)
     simplecov-html (0.13.2)
     simplecov_json_formatter (0.1.4)
-    super_diff (0.16.0)
+    stringio (3.1.7)
+    super_diff (0.17.0)
       attr_extras (>= 6.2.4)
       diff-lcs
       patience_diff
     thor (1.4.0)
+    tsort (0.2.0)
     tzinfo (2.0.6)
       concurrent-ruby (~> 1.0)
     unicode-display_width (3.2.0)
       unicode-emoji (~> 4.1)
     unicode-emoji (4.1.0)
-    uri (1.0.3)
+    uri (1.0.4)
     zeitwerk (2.7.3)
 
 PLATFORMS
@@ -166,9 +188,9 @@ PLATFORMS
 
 DEPENDENCIES
   bundler (~> 2.0)
-  byebug
   cocina-models!
   committee
+  debug
   rake (~> 13.0)
   rspec (~> 3.0)
   rspec_junit_formatter

data/README.md

@@ -91,32 +91,8 @@ RAILS_ENV=production bin/validate-cocina -p 8
 
 ## Running Reports in DSA
 
-Custom reports stored in dor-services-app can be run similarly to validation testing described above.
-
-1. Connect to the `sdr-infra` box:
-    ```shell
-    ssh sdr-infra
-    ```
-1. Start a shell as the `deploy` user:
-    ```shell
-    # you may or may not need to supply the `-n SUNETID` argument
-    ksu deploy
-    ```
-1. Go to the `~/dor-services-app` directory and reset to main if needed (verify nobody else is using this first though):
-    ```shell
-    cd ~/dor-services-app
-    git status # see if there are any unsaved changes, if so, you may need to git stash them
-    git pull # OR git reset --hard main   to just ditch any local unsaved changes
-    ```
-1. Connect to the desired database by setting the environment variables as described in the section above.  This must be done each time you SSH back into the box to run a new report.
-1. Run the report (good idea to do it in a screen or via background process in case you get disconnected):
-    ```shell
-    bundle exec bin/rails r -e production "BadIso8601Dates.report" > BadIso8601Dates.csv
-    ```
-1. When done, you can pull the report to your laptop as needed:
-    ```shell
-    scp sdr-infra:/opt/app/deploy/dor-services-app/BadIso8601Dates.csv .
-    ```
+See https://github.com/sul-dlss/dor-services-app/blob/main/README.md#running-reports
+
 
 ## Releasing a patch change
 A patch change is a change that (1) does not affect the data model; (2) does not alter the openapi.yml; and more broadly (3) does not matter if some applications have the change and others do not.
@@ -143,7 +119,7 @@ Send a note to `#dlss-infra-chg-mgmt` on Slack to let people know what is changi
 The release process is much like any other gem. While on main:
 1. Bump the version in `lib/cocina/models/version.rb`
 2. `bundle install` so that `Gemfile.lock` is updated.
-3. Commit those changes. 
+3. Commit those changes.
 4. Run:
 ```
 bundle exec rake release
@@ -179,11 +155,11 @@ Copy and paste the cocina-models schemas to each project's `openapi.yml`. By con
 If you updated the `openapi.yml` in step 3A, use the same PR for step 3B. Why? When [dor-services-app](https://github.com/sul-dlss/dor-services-app), for example, is updated to use the new models (via the auto-update script), these clients should be updated at the same time or there is risk of models produced by dor-services-app not being acceptable to the clients.
 
 1. Perform `bundle update --conservative cocina-models dor-services-client` in the  services above and make PRs for those repos if they don't already exist. You may first need to update how these gems are pinned in the `Gemfile` in order to bump them.
-2. Note that sdr-client is not currently used in these applications, but if it were, would also need to be bumped to the latest release. 
+2. Note that sdr-client is not currently used in these applications, but if it were, would also need to be bumped to the latest release.
 
 #### Step 3C: Merge 'em
 
-Get the directly coupled services PRs merged before the deploy in step 5. 
+Get the directly coupled services PRs merged before the deploy in step 5.
 
 See the IMPORTANT note above about the timing of merging these PRs if you are waiting for dependency updates to make the updates to other dependent applications.
 
@@ -211,7 +187,7 @@ Create a branch and update cocina-models:
 ```
 bundle update --conservative cocina-models
 ```
-Once merged, it will deploy to stage via CD. 
+Once merged, it will deploy to stage via CD.
 
 ### Step 5: Deploy and test
 
@@ -228,7 +204,7 @@ It is safest to ensure _all_ the integration tests run cleanly.  However, patch
 
 **[Turn off Google Books](https://sul-gbooks-prod.stanford.edu/features) when deploying to production.** This avoids failed deposit due to a temporary Cocina model mismatch. Unlike other applications, the deposits will fail without retry and require manual remediation.
 
-In addition to deploying infrastructure apps via sdr-deploy, tag and cut a release of purl-fetcher. That will trigger its deploy to production. 
+In addition to deploying infrastructure apps via sdr-deploy, tag and cut a release of purl-fetcher. That will trigger its deploy to production.
 
 ## Usage conventions
 

data/description_types.yml

@@ -99,6 +99,8 @@ contributor.note:
     description: Institution with which the contributor is associated.
   - value: citation status
     description: Indicator of whether the contributor should be included in the citation.
+  - value: contact email
+    description: Preferred email contact for contributor.
   - value: description
     description: Biographical information about the contributor.
 event:

data/docs/description_types.md

@@ -106,6 +106,8 @@ _Path: contributor.note.type_
     * Institution with which the contributor is associated.
   * citation status
     * Indicator of whether the contributor should be included in the citation.
+  * contact email
+    * Preferred email contact for contributor.
   * description
     * Biographical information about the contributor.
 # Event types

data/lib/cocina/generator/datatype.rb

@@ -10,7 +10,7 @@ module Cocina
 
           module Cocina
             module Models
-              #{name} = Types::String#{pattern}#{enum}
+              #{preamble}#{name} = Types::String#{pattern}#{enum}
             end
           end
         RUBY

data/lib/cocina/generator/generator.rb

@@ -1,5 +1,6 @@
 # frozen_string_literal: true
 
+require 'debug'
 require 'fileutils'
 
 module Cocina

data/lib/cocina/generator/schema_array.rb

@@ -7,7 +7,7 @@ module Cocina
       GENERIC_ITEMS_NAME = 'items'
 
       def generate
-        "attribute :#{name.camelize(:lower)}, Types::Strict::Array.of(#{array_of_type}).default([].freeze)"
+        "#{preamble}attribute :#{name.camelize(:lower)}, Types::Strict::Array.of(#{array_of_type}).default([].freeze)"
       end
 
       def array_of_type

data/lib/cocina/generator/schema_base.rb

@@ -46,7 +46,15 @@ module Cocina
       def description
         return '' unless schema_doc.description
 
-        "# #{schema_doc.description}\n"
+        to_multiline_comment(schema_doc.description)
+      end
+
+      def to_multiline_comment(string)
+        string
+          .split(/(.{80,}?) /)
+          .compact_blank
+          .map { |comment_chunk| "# #{comment_chunk}\n" }
+          .join
       end
 
       def deprecation
@@ -58,7 +66,7 @@ module Cocina
       def example
         return '' unless schema_doc.example
 
-        "# example: #{schema_doc.example}\n"
+        to_multiline_comment("example: #{schema_doc.example}")
       end
 
       def relaxed_comment

data/lib/cocina/generator/schema_ref.rb

@@ -6,9 +6,9 @@ module Cocina
     class SchemaRef < SchemaBase
       def generate
         if required && !relaxed
-          "attribute(:#{name.camelize(:lower)}, #{schema_doc.name}.default { #{schema_doc.name}.new })"
+          "#{preamble}attribute(:#{name.camelize(:lower)}, #{schema_doc.name}.default { #{schema_doc.name}.new })"
         else
-          "attribute? :#{name.camelize(:lower)}, #{schema_doc.name}.optional"
+          "#{preamble}attribute? :#{name.camelize(:lower)}, #{schema_doc.name}.optional"
         end
       end
     end

data/lib/cocina/generator/union_type.rb

@@ -10,7 +10,7 @@ module Cocina
 
           module Cocina
             module Models
-              #{name} = #{type_names}
+              #{preamble}#{name} = #{type_names}
             end
           end
         RUBY

data/lib/cocina/generator/vocab.rb

@@ -52,11 +52,12 @@ module Cocina
       private_constant :BASE, :URIS
 
       def vocabs
-        type_properties = schemas.values.map { |schema| schema.properties&.[]('type') }.compact
-        type_properties.map(&:enum).flat_map(&:to_a)
-                       .filter { |vocab| vocab.start_with?(BASE) }
-                       .uniq
-                       .sort
+        schemas.values
+               .filter_map { |schema| schema.properties&.[]('type')&.enum }
+               .flat_map(&:to_a)
+               .select { |vocab| vocab.start_with?(BASE) }
+               .uniq
+               .sort
       end
 
       def names

data/lib/cocina/models/access_role.rb

@@ -6,6 +6,7 @@ module Cocina
     class AccessRole < Struct
       # Name of role
       attribute :name, Types::Strict::String.enum('dor-apo-depositor', 'dor-apo-manager', 'dor-apo-viewer', 'sdr-administrator', 'sdr-viewer', 'hydrus-collection-creator', 'hydrus-collection-manager', 'hydrus-collection-depositor', 'hydrus-collection-item-depositor', 'hydrus-collection-reviewer', 'hydrus-collection-viewer')
+      # The users and groups that are members of the role
       attribute :members, Types::Strict::Array.of(AccessRoleMember).default([].freeze)
     end
   end

data/lib/cocina/models/admin_policy.rb

@@ -17,6 +17,7 @@ module Cocina
       attribute :externalIdentifier, Druid
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
+      # Administrative properties for an AdminPolicy
       attribute(:administrative, AdminPolicyAdministrative.default { AdminPolicyAdministrative.new })
       attribute? :description, Description.optional
     end

data/lib/cocina/models/admin_policy_access_template.rb

@@ -2,15 +2,21 @@
 
 module Cocina
   module Models
-    # Provides the template of access settings that is copied to the items governed by an AdminPolicy. This is almost the same as DROAccess, but it provides no defaults and has no embargo.
+    # Provides the template of access settings that is copied to the items governed by
+    # an AdminPolicy. This is almost the same as DROAccess, but it provides no defaults
+    # and has no embargo.
     class AdminPolicyAccessTemplate < Struct
       # The human readable copyright statement that applies
       # example: Copyright World Trade Organization
       attribute? :copyright, Copyright.optional
       # The human readable use and reproduction statement that applies
-      # example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
+      # example: Property rights reside with the repository. Literary rights reside with
+      # the creators of the documents or their heirs. To obtain permission to publish or
+      # reproduce, please contact the Public Services Librarian of the Dept. of Special Collections
+      # (http://library.stanford.edu/spc).
       attribute? :useAndReproductionStatement, UseAndReproductionStatement.optional
-      # The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
+      # The license governing reuse of the DRO. Should be an IRI for known licenses (i.e.
+      # CC, RightsStatement.org URI, etc.).
       attribute? :license, License.optional.enum('https://www.gnu.org/licenses/agpl.txt', 'https://www.apache.org/licenses/LICENSE-2.0', 'https://opensource.org/licenses/BSD-2-Clause', 'https://opensource.org/licenses/BSD-3-Clause', 'https://creativecommons.org/licenses/by/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode', 'https://creativecommons.org/licenses/by-nd/4.0/legalcode', 'https://creativecommons.org/licenses/by-sa/4.0/legalcode', 'https://creativecommons.org/publicdomain/zero/1.0/legalcode', 'https://opensource.org/licenses/cddl1', 'https://www.eclipse.org/legal/epl-2.0', 'https://www.gnu.org/licenses/gpl-3.0-standalone.html', 'https://www.isc.org/downloads/software-support-policy/isc-license/', 'https://www.gnu.org/licenses/lgpl-3.0-standalone.html', 'https://opensource.org/licenses/MIT', 'https://www.mozilla.org/MPL/2.0/', 'https://opendatacommons.org/licenses/by/1-0/', 'http://opendatacommons.org/licenses/odbl/1.0/', 'https://opendatacommons.org/licenses/odbl/1-0/', 'https://creativecommons.org/publicdomain/mark/1.0/', 'https://opendatacommons.org/licenses/pddl/1-0/', 'https://creativecommons.org/licenses/by/3.0/legalcode', 'https://creativecommons.org/licenses/by-sa/3.0/legalcode', 'https://creativecommons.org/licenses/by-nd/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc-sa/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc-nd/3.0/legalcode', 'https://cocina.sul.stanford.edu/licenses/none')
       # Access level.
       # Validation of this property is relaxed. See the openapi for full validation.

data/lib/cocina/models/admin_policy_administrative.rb

@@ -4,16 +4,25 @@ module Cocina
   module Models
     # Administrative properties for an AdminPolicy
     class AdminPolicyAdministrative < Struct
+      # Provides the template of access settings that is copied to the items governed by
+      # an AdminPolicy. This is almost the same as DROAccess, but it provides no defaults
+      # and has no embargo.
       attribute(:accessTemplate, AdminPolicyAccessTemplate.default { AdminPolicyAccessTemplate.new })
+      # When you register an item with this admin policy, these are the workflows that are
+      # available.
       attribute :registrationWorkflow, Types::Strict::Array.of(Types::Strict::String).default([].freeze)
-      # An additional workflow to start for objects managed by this admin policy once the end-accession workflow step is complete
+      # An additional workflow to start for objects managed by this admin policy once the
+      # end-accession workflow step is complete
       # example: wasCrawlPreassemblyWF
       attribute? :disseminationWorkflow, Types::Strict::String
+      # When you register an item with this admin policy, these are the collections that
+      # are available.
       attribute :collectionsForRegistration, Types::Strict::Array.of(Types::Strict::String).default([].freeze)
       # example: druid:bc123df4567
       attribute :hasAdminPolicy, Druid
       # example: druid:bc123df4567
       attribute :hasAgreement, Druid
+      # The access roles conferred by this AdminPolicy (used by Argo)
       attribute :roles, Types::Strict::Array.of(AccessRole).default([].freeze)
     end
   end

data/lib/cocina/models/admin_policy_lite.rb

@@ -15,7 +15,10 @@ module Cocina
       attribute :externalIdentifier, Druid
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
+      # Administrative properties for an AdminPolicy
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :administrative, AdminPolicyAdministrative.optional
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :description, Description.optional
     end
   end

data/lib/cocina/models/admin_policy_with_metadata.rb

@@ -18,6 +18,7 @@ module Cocina
       attribute :externalIdentifier, Druid
       attribute :label, Types::Strict::String
       attribute :version, Types::Strict::Integer
+      # Administrative properties for an AdminPolicy
       attribute(:administrative, AdminPolicyAdministrative.default { AdminPolicyAdministrative.new })
       attribute? :description, Description.optional
       # When the object was created.

data/lib/cocina/models/applies_to.rb

@@ -2,7 +2,8 @@
 
 module Cocina
   module Models
-    # Property model for indicating the parts, aspects, or versions of the resource to which a descriptive element is applicable.
+    # Property model for indicating the parts, aspects, or versions of the resource to
+    # which a descriptive element is applicable.
     class AppliesTo < Struct
       attribute :appliesTo, Types::Strict::Array.of(DescriptiveBasicValue).default([].freeze)
     end

data/lib/cocina/models/barcode.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A barcode
     Barcode = BusinessBarcode | LaneMedicalBarcode | CatkeyBarcode | StandardBarcode
   end
 end

data/lib/cocina/models/business_barcode.rb

@@ -2,6 +2,8 @@
 
 module Cocina
   module Models
+    # The barcode associated with a business library DRO object, prefixed with 2050
+    # example: 20503740296
     BusinessBarcode = Types::String.constrained(format: /^2050[0-9]{7}$/)
   end
 end

data/lib/cocina/models/catalog_link.rb

@@ -2,6 +2,7 @@
 
 module Cocina
   module Models
+    # A linkage between an object and a catalog record
     CatalogLink = FolioCatalogLink | SymphonyCatalogLink
   end
 end

data/lib/cocina/models/catkey_barcode.rb

@@ -2,6 +2,9 @@
 
 module Cocina
   module Models
+    # The barcode associated with a DRO object based on catkey, prefixed with a catkey
+    # followed by a hyphen
+    # example: 6772719-1001
     CatkeyBarcode = Types::String.constrained(format: /^[0-9]+-[0-9]+$/)
   end
 end

data/lib/cocina/models/citation_only_access.rb

@@ -2,7 +2,8 @@
 
 module Cocina
   module Models
-    # A type of access for an object wherein users can see the metadata and a list of files, but the files will not have view or download access
+    # A type of access for an object wherein users can see the metadata and a list of files,
+    # but the files will not have view or download access
     class CitationOnlyAccess < Struct
       # Access level.
       attribute :view, Types::Strict::String.enum('citation-only')

data/lib/cocina/models/cocina_version.rb

@@ -2,6 +2,8 @@
 
 module Cocina
   module Models
+    # The version of Cocina with which this object conforms.
+    # example: 1.2.3
     CocinaVersion = Types::String.constrained(format: /^\d+\.\d+\.\d+$/)
   end
 end

data/lib/cocina/models/collection.rb

@@ -2,7 +2,8 @@
 
 module Cocina
   module Models
-    # A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.
+    # A group of Digital Repository Objects that indicate some type of conceptual grouping
+    # within the domain that is worth reusing across the system.
     class Collection < Struct
       include Validatable
 
@@ -25,6 +26,7 @@ module Cocina
       attribute :label, Types::Strict::String
       # Version for the Collection within SDR.
       attribute :version, Types::Strict::Integer
+      # Access metadata for collections
       attribute(:access, CollectionAccess.default { CollectionAccess.new })
       attribute(:administrative, Administrative.default { Administrative.new })
       attribute(:description, Description.default { Description.new })

data/lib/cocina/models/collection_access.rb

@@ -10,9 +10,13 @@ module Cocina
       # example: Copyright World Trade Organization
       attribute? :copyright, Copyright.optional
       # The human readable use and reproduction statement that applies
-      # example: Property rights reside with the repository. Literary rights reside with the creators of the documents or their heirs. To obtain permission to publish or reproduce, please contact the Public Services Librarian of the Dept. of Special Collections (http://library.stanford.edu/spc).
+      # example: Property rights reside with the repository. Literary rights reside with
+      # the creators of the documents or their heirs. To obtain permission to publish or
+      # reproduce, please contact the Public Services Librarian of the Dept. of Special Collections
+      # (http://library.stanford.edu/spc).
       attribute? :useAndReproductionStatement, UseAndReproductionStatement.optional
-      # The license governing reuse of the DRO. Should be an IRI for known licenses (i.e. CC, RightsStatement.org URI, etc.).
+      # The license governing reuse of the DRO. Should be an IRI for known licenses (i.e.
+      # CC, RightsStatement.org URI, etc.).
       attribute? :license, License.optional.enum('https://www.gnu.org/licenses/agpl.txt', 'https://www.apache.org/licenses/LICENSE-2.0', 'https://opensource.org/licenses/BSD-2-Clause', 'https://opensource.org/licenses/BSD-3-Clause', 'https://creativecommons.org/licenses/by/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc-nd/4.0/legalcode', 'https://creativecommons.org/licenses/by-nc-sa/4.0/legalcode', 'https://creativecommons.org/licenses/by-nd/4.0/legalcode', 'https://creativecommons.org/licenses/by-sa/4.0/legalcode', 'https://creativecommons.org/publicdomain/zero/1.0/legalcode', 'https://opensource.org/licenses/cddl1', 'https://www.eclipse.org/legal/epl-2.0', 'https://www.gnu.org/licenses/gpl-3.0-standalone.html', 'https://www.isc.org/downloads/software-support-policy/isc-license/', 'https://www.gnu.org/licenses/lgpl-3.0-standalone.html', 'https://opensource.org/licenses/MIT', 'https://www.mozilla.org/MPL/2.0/', 'https://opendatacommons.org/licenses/by/1-0/', 'http://opendatacommons.org/licenses/odbl/1.0/', 'https://opendatacommons.org/licenses/odbl/1-0/', 'https://creativecommons.org/publicdomain/mark/1.0/', 'https://opendatacommons.org/licenses/pddl/1-0/', 'https://creativecommons.org/licenses/by/3.0/legalcode', 'https://creativecommons.org/licenses/by-sa/3.0/legalcode', 'https://creativecommons.org/licenses/by-nd/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc-sa/3.0/legalcode', 'https://creativecommons.org/licenses/by-nc-nd/3.0/legalcode', 'https://cocina.sul.stanford.edu/licenses/none')
     end
   end

data/lib/cocina/models/collection_identification.rb

@@ -4,7 +4,14 @@ module Cocina
   module Models
     class CollectionIdentification < Struct
       attribute :catalogLinks, Types::Strict::Array.of(CatalogLink).default([].freeze)
-      # 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. The format is: "namespace:identifier"
+      # 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. The format is: "namespace:identifier"
 
       # example: sul:PC0170_s3_Fiesta_Bowl_2012-01-02_210609_2026
       attribute? :sourceId, SourceId.optional

data/lib/cocina/models/collection_lite.rb

@@ -2,7 +2,8 @@
 
 module Cocina
   module Models
-    # A group of Digital Repository Objects that indicate some type of conceptual grouping within the domain that is worth reusing across the system.
+    # A group of Digital Repository Objects that indicate some type of conceptual grouping
+    # within the domain that is worth reusing across the system.
     class CollectionLite < Struct
       include Checkable
 
@@ -23,9 +24,14 @@ module Cocina
       attribute :label, Types::Strict::String
       # Version for the Collection within SDR.
       attribute :version, Types::Strict::Integer
+      # Access metadata for collections
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :access, CollectionAccess.optional
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :administrative, Administrative.optional
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :description, Description.optional
+      # Validation of this property is relaxed. See the openapi for full validation.
       attribute? :identification, CollectionIdentification.optional
     end
   end

data/lib/cocina/models/collection_with_metadata.rb

@@ -25,6 +25,7 @@ module Cocina
       attribute :label, Types::Strict::String
       # Version for the Collection within SDR.
       attribute :version, Types::Strict::Integer
+      # Access metadata for collections
       attribute(:access, CollectionAccess.default { CollectionAccess.new })
       attribute(:administrative, Administrative.default { Administrative.new })
       attribute(:description, Description.default { Description.new })