rdf-vocab 3.1.7 → 3.1.8

data/lib/rdf/vocab/pcdm.rb

@@ -57,7 +57,7 @@ module RDF::Vocab
 
     # Ontology definition
     ontology :"http://pcdm.org/models#",
-      comment: %(Ontology for the Portland Common Data Model, intended to underlie a wide array of repository and DAMS applications.).freeze,
+      comment: "Ontology for the Portland Common Data Model, intended to underlie a wide array of repository and DAMS applications.".freeze,
       "dc:modified": "2016/04/18".freeze,
       "dc:publisher": "http://www.duraspace.org/".freeze,
       "dc:title": "Portland Common Data Model".freeze,
@@ -67,43 +67,24 @@ module RDF::Vocab
 
     # Class definitions
     term :AlternateOrder,
-      comment: %(
-        An AlternateOrder is an alternate ordering of its parent's members.  It should only order the
-        parent's members, and otherwise has all of the features of ordering \(some members may be
-        omitted from the order, members may appear more than once in the order, etc.\).
-      ).freeze,
+      comment: "\n        An AlternateOrder is an alternate ordering of its parent's members.  It should only order the\n        parent's members, and otherwise has all of the features of ordering (some members may be\n        omitted from the order, members may appear more than once in the order, etc.).\n      ".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "Alternate Order".freeze,
       subClassOf: "pcdm:Object".freeze,
       type: "rdfs:Class".freeze
     term :Collection,
-      comment: %(
-        A Collection is a group of resources. Collections have descriptive metadata, access metadata,
-        and may links to works and/or collections. By default, member works and collections are an
-        unordered set, but can be ordered using the ORE Proxy class.
-      ).freeze,
+      comment: "\n        A Collection is a group of resources. Collections have descriptive metadata, access metadata,\n        and may links to works and/or collections. By default, member works and collections are an\n        unordered set, but can be ordered using the ORE Proxy class.\n      ".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "Collection".freeze,
       subClassOf: "ore:Aggregation".freeze,
       type: "rdfs:Class".freeze
     term :File,
-      comment: %(
-        A File is a sequence of binary data and is described by some accompanying metadata.
-        The metadata typically includes at least basic technical metadata \(size, content type,
-        modification date, etc.\), but can also include properties related to preservation,
-        digitization process, provenance, etc. Files MUST be contained by exactly one Object.
-      ).freeze,
+      comment: "\n        A File is a sequence of binary data and is described by some accompanying metadata.\n        The metadata typically includes at least basic technical metadata (size, content type,\n        modification date, etc.), but can also include properties related to preservation,\n        digitization process, provenance, etc. Files MUST be contained by exactly one Object.\n      ".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "File".freeze,
       type: "rdfs:Class".freeze
     term :Object,
-      comment: %(
-        An Object is an intellectual entity, sometimes called a "work", "digital object", etc.
-        Objects have descriptive metadata, access metadata, may contain files and other Objects as
-        member "components". Each level of a work is therefore represented by an Object instance,
-        and is capable of standing on its own, being linked to from Collections and other Objects.
-        Member Objects can be ordered using the ORE Proxy class.
-      ).freeze,
+      comment: "\n        An Object is an intellectual entity, sometimes called a \"work\", \"digital object\", etc.\n        Objects have descriptive metadata, access metadata, may contain files and other Objects as\n        member \"components\". Each level of a work is therefore represented by an Object instance,\n        and is capable of standing on its own, being linked to from Collections and other Objects.\n        Member Objects can be ordered using the ORE Proxy class.\n      ".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "Object".freeze,
       subClassOf: "ore:Aggregation".freeze,
@@ -111,7 +92,7 @@ module RDF::Vocab
 
     # Property definitions
     property :fileOf,
-      comment: %(Links from a File to its containing Object.).freeze,
+      comment: "Links from a File to its containing Object.".freeze,
       domain: "pcdm:File".freeze,
       inverseOf: "pcdm:hasFile".freeze,
       isDefinedBy: "pcdm:".freeze,
@@ -120,7 +101,7 @@ module RDF::Vocab
       subPropertyOf: "ore:isAggregatedBy".freeze,
       type: "rdf:Property".freeze
     property :hasFile,
-      comment: %(Links to a File contained by this Object.).freeze,
+      comment: "Links to a File contained by this Object.".freeze,
       domain: "pcdm:Object".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "has file".freeze,
@@ -128,10 +109,7 @@ module RDF::Vocab
       subPropertyOf: "ore:aggregates".freeze,
       type: "rdf:Property".freeze
     property :hasMember,
-      comment: %(Links to a subsidiary Object or Collection. Typically used to link
-          to component parts, such as a book linking to a page.  Note on transitivity: hasMember is
-          not defined as transitive, but applications may treat it as transitive as local needs
-          dictate.).freeze,
+      comment: "Links to a subsidiary Object or Collection. Typically used to link\n          to component parts, such as a book linking to a page.  Note on transitivity: hasMember is\n          not defined as transitive, but applications may treat it as transitive as local needs\n          dictate.".freeze,
       domain: "ore:Aggregation".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "has member".freeze,
@@ -139,7 +117,7 @@ module RDF::Vocab
       subPropertyOf: "ore:aggregates".freeze,
       type: "rdf:Property".freeze
     property :hasRelatedObject,
-      comment: %(Links to a related Object that is not a component part, such as an object representing a donor agreement or policies that govern the resource.).freeze,
+      comment: "Links to a related Object that is not a component part, such as an object representing a donor agreement or policies that govern the resource.".freeze,
       domain: "ore:Aggregation".freeze,
       isDefinedBy: "pcdm:".freeze,
       label: "has related object".freeze,
@@ -147,7 +125,7 @@ module RDF::Vocab
       subPropertyOf: "ore:aggregates".freeze,
       type: "rdf:Property".freeze
     property :memberOf,
-      comment: %(Links from an Object or Collection to a containing Object or Collection.).freeze,
+      comment: "Links from an Object or Collection to a containing Object or Collection.".freeze,
       domain: "ore:Aggregation".freeze,
       inverseOf: "pcdm:hasMember".freeze,
       isDefinedBy: "pcdm:".freeze,
@@ -156,7 +134,7 @@ module RDF::Vocab
       subPropertyOf: "ore:isAggregatedBy".freeze,
       type: "rdf:Property".freeze
     property :relatedObjectOf,
-      comment: %(Links from an Object to a Object or Collection that it is related to.).freeze,
+      comment: "Links from an Object to a Object or Collection that it is related to.".freeze,
       domain: "pcdm:Object".freeze,
       inverseOf: "pcdm:hasRelatedObject".freeze,
       isDefinedBy: "pcdm:".freeze,

data/lib/rdf/vocab/pplan.rb

@@ -6,208 +6,30 @@ module RDF::Vocab
   # @!parse
   #   # Vocabulary for <http://purl.org/net/p-plan#>
   #   #
-  #   # The P-Plan ontology
+  #   # The P-Plan Ontology
   #   #
-  #   # PROV extension for linking Plans and parts of plans to their respective executions. Created by Daniel Garijo and Yolanda Gil
-  #   #
-  #   # PROV extension for linking Plans and parts of plans to their respective executions.
-  #   # @version 1.3
+  #   # The P-PLAN Ontology
   #   class PPLAN < RDF::StrictVocabulary
-  #     # A p-plan:Activity represents the execution process planned in a p-plan:Step
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Activity
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Bundle
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Entity
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :MultiStep
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Plan
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Step
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :Variable
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :correspondsToStep
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :correspondsToVariable
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :hasInputVar
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :hasOutputVar
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isDecomposedAsPlan
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isInputVarOf
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isOutputVarOf
-  #
-  #     # Property that asserts which Step preceeds the current one. 
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isPrecededBy
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isStepOfPlan
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isSubPlanOfPlan
-  #
-  #     # @return [RDF::Vocabulary::Term]
-  #     attr_reader :isVariableOfPlan
-  #
   #   end
   PPLAN = Class.new(RDF::StrictVocabulary("http://purl.org/net/p-plan#")) do
 
     # Ontology definition
     ontology :"http://purl.org/net/p-plan#",
-      comment: %(PROV extension for linking Plans and parts of plans to their respective executions. Created by Daniel Garijo and Yolanda Gil).freeze,
-      "dc:created": "2012-11-10".freeze,
-      "dc:creator": ["http://delicias.dia.fi.upm.es/members/DGarijo#me".freeze, "http://www.isi.edu/~gil/".freeze],
-      "dc:description": "PROV extension for linking Plans and parts of plans to their respective executions.".freeze,
-      "dc:license": "http://creativecommons.org/licenses/by-nc-sa/2.0/".freeze,
-      "dc:modified": "2014-03-12".freeze,
-      "dc:title": "The P-Plan ontology".freeze,
-      "http://purl.org/vocab/vann/preferredNamespacePrefix": "p-plan".freeze,
-      "http://purl.org/vocab/vann/preferredNamespaceUri": "http://purl.org/net/p-plan#".freeze,
-      "owl:versionInfo": "1.3".freeze,
-      type: ["owl:NamedIndividual".freeze, "owl:Ontology".freeze, "owl:Thing".freeze]
-
-    # Class definitions
-    term :Activity,
-      comment: %(A p-plan:Activity represents the execution process planned in a p-plan:Step).freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "Activity".freeze,
-      subClassOf: "prov:Activity".freeze,
-      type: "owl:Class".freeze
-    term :Bundle,
-      isDefinedBy: "pplan:".freeze,
-      label: "Bundle".freeze,
-      "prov:definition": "A p-plan:Bundle is a specific type of prov:Bundle that contains the provenance assertions of the execution of a p-plan:Plan".freeze,
-      subClassOf: ["pplan:Entity".freeze, "prov:Bundle".freeze],
-      type: "owl:Class".freeze
-    term :Entity,
-      isDefinedBy: "pplan:".freeze,
-      label: "Entity".freeze,
-      "prov:definition": "A p-plan:Entity represents the input of the execution of a p-plan:Activity. It corresponds to a p-plan:Variable.".freeze,
-      subClassOf: "prov:Entity".freeze,
-      type: "owl:Class".freeze
-    term :MultiStep,
-      isDefinedBy: "pplan:".freeze,
-      label: "MultiStep".freeze,
-      "prov:definition": "A multi step is the representation of a plan that appears as a step of another plan.".freeze,
-      subClassOf: ["pplan:Plan".freeze, "pplan:Step".freeze],
-      type: "owl:Class".freeze
-    term :Plan,
-      isDefinedBy: "pplan:".freeze,
-      label: "Plan".freeze,
-      "prov:definition": "A p-plan:Plan is a specific type of prov:Plan. It is composed of smaller steps that use and produce Variables.".freeze,
-      subClassOf: ["pplan:Entity".freeze, "prov:Plan".freeze],
-      type: "owl:Class".freeze
-    term :Step,
-      isDefinedBy: "pplan:".freeze,
-      label: "Step".freeze,
-      "prov:definition": "A p-plan:Step represents the planned execution activity".freeze,
-      type: "owl:Class".freeze
-    term :Variable,
-      isDefinedBy: "pplan:".freeze,
-      label: "Variable".freeze,
-      "prov:definition": "A p-plan:Variable represents a description of the input of the planned Activity (p-plan:Step)".freeze,
-      type: "owl:Class".freeze
-
-    # Property definitions
-    property :correspondsToStep,
-      domain: "pplan:Activity".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "correspondsToStep".freeze,
-      "prov:definition": "p-plan:correspondsToStep links a p-plan:Activity to its planned p-plan:Step".freeze,
-      range: "pplan:Step".freeze,
-      type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze]
-    property :correspondsToVariable,
-      domain: "pplan:Entity".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "correspondsToVariable".freeze,
-      "prov:definition": "p-plan:correspondsToVariable binds a p-plan:Entity (used by a p-plan:Activity in the execution of a plan) to the p-plan:Variable it represented it in the p-plan:Plan.".freeze,
-      range: "pplan:Variable".freeze,
-      type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze]
-    property :hasInputVar,
-      domain: "pplan:Step".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "hasInputVar".freeze,
-      "prov:definition": "p-plan:hasInputVar binds a p-plan:Step to the p-plan:Variable that takes as input for the planned execution".freeze,
-      range: "pplan:Variable".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :hasOutputVar,
-      domain: "pplan:Step".freeze,
-      inverseOf: "pplan:isOutputVarOf".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "hasOutputVar".freeze,
-      "prov:definition": "p-plan:hasOutputVar binds a p-plan:Step to the p-plan:Variable that will be produced as output in the planned execution".freeze,
-      range: "pplan:Variable".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :isDecomposedAsPlan,
-      domain: "pplan:MultiStep".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isDecomposedAsPlan".freeze,
-      "prov:definition": "The p-plan:isDecomposedAsPlan relationship binds a p-plan:MultiStep to the p-plan:Plan holding the definition of that step. That is, p-plan:isDecomposedAsPlan links the MultiStep to the Plan sptecification where it is decomposed.".freeze,
-      range: "pplan:Plan".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :isInputVarOf,
-      domain: "pplan:Variable".freeze,
-      inverseOf: "pplan:hasInputVar".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isInputVarOf".freeze,
-      "prov:definition": "p-plan:isInputVarOf links an input variable of a step to the step.".freeze,
-      range: "pplan:Step".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :isOutputVarOf,
-      domain: "pplan:Variable".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isOutputVarOf".freeze,
-      "prov:definition": "p-plan:isOutputVarOf is intended to link an output variable of a step to the step.".freeze,
-      range: "pplan:Step".freeze,
-      type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze]
-    property :isPrecededBy,
-      comment: %(Property that asserts which Step preceeds the current one. ).freeze,
-      domain: "pplan:Step".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isPrecededBy".freeze,
-      range: "pplan:Step".freeze,
-      type: ["owl:ObjectProperty".freeze, "owl:TransitiveProperty".freeze]
-    property :isStepOfPlan,
-      domain: "pplan:Step".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isStepOfPlan".freeze,
-      "prov:definition": "p-plan:isStepOfPlan links a p-plan:Step to the p-plan:Plan which it corresponds to.".freeze,
-      range: "pplan:Plan".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :isSubPlanOfPlan,
-      domain: "pplan:Plan".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isSubPlanOfPlan".freeze,
-      "prov:definition": "A p-plan:Plan may be a subplan of another bigger p-plan:Plan. p-plan:isSubPlanOfPlan is used to state the link among the two different plans. Note that if p1 is a p-plan:subPlan of p2, p1will not necessarily be a step of p2. A multistep will represent p1 in p2, and link to p1 with the p-plan.hasStepDecomposition relationship.".freeze,
-      range: "pplan:Plan".freeze,
-      subPropertyOf: "owl:topObjectProperty".freeze,
-      type: "owl:ObjectProperty".freeze
-    property :isVariableOfPlan,
-      domain: "pplan:Variable".freeze,
-      isDefinedBy: "pplan:".freeze,
-      label: "isVariableofPlan".freeze,
-      "prov:definition": "p-plan:IsVariableOfPlan binds a p-plan:Variable to the p-plan:Plan it corresponds to.".freeze,
-      range: "pplan:Plan".freeze,
-      type: "owl:ObjectProperty".freeze
+      "dc:created": "17 September 2013".freeze,
+      "dc:creator": ["http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze, "http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze, "http://www.isi.edu/~gil/".freeze],
+      "dc:isVersionOf": "http://purl.org/net/p-plan".freeze,
+      "dc:modified": "Release 12 March 2014".freeze,
+      "dc:rights": "https://creativecommons.org/licenses/by/4.0/".freeze,
+      "dc:title": ["The P-PLAN Ontology".freeze, "The P-Plan Ontology".freeze],
+      "prov:wasAttributedTo": ["http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze, "http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze, "http://www.isi.edu/~gil/".freeze],
+      "schema:author": ["http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze, "http://www.isi.edu/~gil/".freeze],
+      "schema:creator": "http://delicias.dia.fi.upm.es/members/DGarijo/#me".freeze,
+      "schema:dateCreated": "17 September 2013".freeze,
+      "schema:dateModified": "Release 12 March 2014".freeze,
+      "schema:mentions": ["http://www.w3.org/TR/prov-o/".freeze, "pplan:PROV-DM".freeze, "pplan:PROV-O".freeze],
+      "schema:name": ["The P-PLAN Ontology".freeze, "The P-Plan Ontology".freeze],
+      "schema:version": "1.3".freeze,
+      type: ["foaf:Document".freeze, "owl:Ontology".freeze, "schema:TechArticle".freeze, "schema:WebPage".freeze],
+      "xhv:license": "https://creativecommons.org/licenses/by/4.0/".freeze
   end
 end

data/lib/rdf/vocab/premis.rb

@@ -12,9 +12,9 @@ module RDF::Vocab
   #   # @version 1.0.0
   #   # @see http://multimedialab.elis.ugent.be/users/samcoppe/ontologies/Premis/index.html for the OWL Documentation of the ontology.
   #   class PREMIS < RDF::StrictVocabulary
-  #     # The Agent entity aggregates information about attributes or characteristics of agents (persons, organizations, or software) associated with rights management and preservation events in the life of a data object. Agent information serves to identify an agent unambiguously from all other Agent entities.
-  #     #
   #     # Entity properties: May hold or grant one or more rights. May carry out, authorize, or compel one or more events. May create or act upon one or more objects through an event or with respect to a rights statement.
+  #     #
+  #     # The Agent entity aggregates information about attributes or characteristics of agents (persons, organizations, or software) associated with rights management and preservation events in the life of a data object. Agent information serves to identify an agent unambiguously from all other Agent entities.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Agent
   #
@@ -28,27 +28,27 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Bitstream
   #
+  #     # Usage Notes: If the preservation repository uses the objectIdentifier as a handle for retrieving data, contentLocation is implicit and does not need to be recorded.
+  #     #
   #     # Creation / Maintenance Notes: A preservation repository should never refer to content that it does not control. Therefore, the PREMIS working group assumed that the repository will always assign the contentLocation, probably by program.
   #     #
   #     # Definition: Information needed to retrieve a file from the storage system, or to access a bitstream within a file.
-  #     #
-  #     # Usage Notes: If the preservation repository uses the objectIdentifier as a handle for retrieving data, contentLocation is implicit and does not need to be recorded.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :ContentLocation
   #
-  #     # Usage Notes: When rights basis is a copyright, copyrightInformation should be provided. Repositories may need to extend this with more detailed information. See the California Digital Library's copyrightMD schema (www.cdlib.org/inside/projects/rights/schema/) for an example of a more detailed scheme.
-  #     #
   #     # Definition: Information about the copyright status of the object(s).
+  #     #
+  #     # Usage Notes: When rights basis is a copyright, copyrightInformation should be provided. Repositories may need to extend this with more detailed information. See the California Digital Library's copyrightMD schema (www.cdlib.org/inside/projects/rights/schema/) for an example of a more detailed scheme.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :CopyrightInformation
   #
-  #     # Creation / Maintenance Notes: If the object was created by the repository, assignment of creating application information should be straightforward. If the object was created outside the repository, it is possible this information could be supplied by the depositor. It might also be extracted from the file itself; the name of the creating application is often embedded within the file.
-  #     #
   #     # Rationale: Information about the creating application, including the version of the application and the date the file was created, can be useful for problem solving purposes. For example, it is not uncommon for certain versions of software to be known for causing conversion errors or introducing artifacts. It is also useful to determine which rendering software is available for the digital object. For example, if you know that the Distiller program created the PDF file, you know it will be renderable with (among other programs) Adobe Reader.
   #     #
   #     # Definition: Information about the application that created the object.
   #     #
   #     # Usage Notes: This semantic unit applies to both objects created external to the repository and subsequently ingested, and to objects created by the repository, for example, through migration events. The creatingApplication container is repeatable if more than one application processed the object in turn. For example, a file could be created by Microsoft Word and later turned into a PDF using Adobe Acrobat. Details of both the Word and Acrobat applications may be recorded. However, if both files are stored in the repository, each file should be completely described as an Object entity and linked by using relationship information with a relationshipType “derivation.” It may also be repeated to record the creating application before the object was ingested as well as the creating application used as part of the ingest process. For example, an HTML file was created pre-ingest using Dreamweaver, and the Web crawler Heritrix then captured a snapshot of the files as part of the ingest. The amount of information needed for creatingApplication given here is minimal. For more granularity, extensibility is provided. Rather than having each repository record this locally, it would be preferable to have a registry of this information similar to format or environment registries.
+  #     #
+  #     # Creation / Maintenance Notes: If the object was created by the repository, assignment of creating application information should be straightforward. If the object was created outside the repository, it is possible this information could be supplied by the depositor. It might also be extracted from the file itself; the name of the creating application is often embedded within the file.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :CreatingApplication
   #
@@ -62,11 +62,11 @@ module RDF::Vocab
   #
   #     # Usage Notes: All of this semantic units’ subunits are optional. At least one subunit (i.e. environmentNote, dependency, software, hardware, and/or environmentExtension) must be present if this container is included.
   #     #
-  #     # Creation / Maintenance Notes: This information may be omitted when the repository is doing only bit-level preservation on the object. Rather than having each repository record this locally, it would be preferable to have a registry of environment information similar to proposed registries of format information. Repositories may choose to design mechanisms for inheritance, so that if the environment required for each file within a representation is identical to the environment recorded for the representation as a whole, it is not necessary to store this information in each file.
-  #     #
   #     # Definition: Hardware/software combinations supporting use of the object.
   #     #
   #     # Rationale: Environment is the means by which the user renders and interacts with content. Separation of digital content from its environmental context can result in the content becoming unusable.
+  #     #
+  #     # Creation / Maintenance Notes: This information may be omitted when the repository is doing only bit-level preservation on the object. Rather than having each repository record this locally, it would be preferable to have a registry of environment information similar to proposed registries of format information. Repositories may choose to design mechanisms for inheritance, so that if the environment required for each file within a representation is identical to the environment recorded for the representation as a whole, it is not necessary to store this information in each file.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Environment
   #
@@ -76,17 +76,17 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Event
   #
-  #     # Definition: A detailed description of the result or product of the event.
-  #     #
   #     # Rationale: An event outcome may be sufficiently complex that a coded description is not adequate to document it.
   #     #
   #     # Usage Notes: This may be used to record all error and warning messages issued by a program involved in the event or to record a pointer to an error log. If the event was a validity check (e.g., profile conformance) any anomalies or quirks discovered would be recorded here. All subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcomeDetailNote and/or eventOutcomeDetailExtension) must be present if this container is included.
+  #     #
+  #     # Definition: A detailed description of the result or product of the event.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :EventOutcomeDetail
   #
-  #     # Definition: Information about the outcome of an event.
-  #     #
   #     # Usage Notes: A repository may wish to supplement a coded eventOutcome value with additional information in eventOutcomeDetail. Since events may have more than one outcome, the container is repeatable. All subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcome or eventOutcomeDetail) must be present if this container is included.
+  #     #
+  #     # Definition: Information about the outcome of an event.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :EventOutcomeInformation
   #
@@ -94,41 +94,41 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :File
   #
-  #     # Usage Notes: To perform a fixity check, a message digest calculated at some earlier time is compared with a message digest calculated at a later time. If the digests are the same, the object was not altered in the interim. Recommended practice is to use two or more message digests calculated by different algorithms. (Note that the terms “message digest” and “checksum” are commonly used interchangeably. However, the term “checksum” is more correctly used for the product of a cyclical redundancy check (CRC), whereas the term “message digest” refers to the result of a cryptographic hash function, which is what is referred to here.) The act of performing a fixity check and the date it occurred would be recorded as an Event. The result of the check would be recorded as the eventOutcome. Therefore, only the messageDigestAlgorithm and messageDigest need to be recorded as objectCharacteristics for future comparison. Representation level: It could be argued that if a representation consists of a single file or if all the files comprised by a representation are combined (e.g., zipped) into a single file, then a fixity check could be performed on the representation. However, in both cases the fixity check is actually being performed on a file, which in this case happens to be coincidental with a representation. Bitstream level: Message digests can be computed for bitstreams although they are not as common as with files. For example, the JPX format, which is a JPEG2000 format, supports the inclusion of MD5 or SHA-1 message digests in internal metadata that was calculated on any range of bytes of the file.
-  #     #
   #     # Creation / Maintenance Notes: Automatically calculated and recorded by repository.
   #     #
+  #     # Usage Notes: To perform a fixity check, a message digest calculated at some earlier time is compared with a message digest calculated at a later time. If the digests are the same, the object was not altered in the interim. Recommended practice is to use two or more message digests calculated by different algorithms. (Note that the terms “message digest” and “checksum” are commonly used interchangeably. However, the term “checksum” is more correctly used for the product of a cyclical redundancy check (CRC), whereas the term “message digest” refers to the result of a cryptographic hash function, which is what is referred to here.) The act of performing a fixity check and the date it occurred would be recorded as an Event. The result of the check would be recorded as the eventOutcome. Therefore, only the messageDigestAlgorithm and messageDigest need to be recorded as objectCharacteristics for future comparison. Representation level: It could be argued that if a representation consists of a single file or if all the files comprised by a representation are combined (e.g., zipped) into a single file, then a fixity check could be performed on the representation. However, in both cases the fixity check is actually being performed on a file, which in this case happens to be coincidental with a representation. Bitstream level: Message digests can be computed for bitstreams although they are not as common as with files. For example, the JPX format, which is a JPEG2000 format, supports the inclusion of MD5 or SHA-1 message digests in internal metadata that was calculated on any range of bytes of the file.
+  #     #
   #     # Definition: Information used to verify whether an object has been altered in an undocumented or unauthorized way.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Fixity
   #
-  #     # Usage Notes: A bitstream embedded within a file may have different characteristics than the larger file. For example, a bitstream in LaTex format could be embedded within an SGML file, or multiple images using different colorspaces could be embedded within a TIFF file. format must be recorded for every object. When the bitstream format can be recognized by the repository and the repository might want to treat the bitstream differently from the embedding file for preservation purposes, format can be recorded for embedded bitstreams. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either formatDesignation or formatRegistry) must be present if this container is included or both may be used. If the subunit (formatDesignation or formatRegistry) needs to be repeated, the entire format container is repeated. This allows for association of format designation with a particular set of format registry information. For example, if the precise format cannot be determined and two format designations are recorded, each is given within a separate format container. The format container may also be repeated for multiple format registry entries.
-  #     #
-  #     # Creation / Maintenance Notes: The format of a file or bitstream should be ascertained by the repository on ingest. Even if this information is provided by the submitter, directly in metadata or indirectly via the file name extension, recommended practice is to independently identify the format by parsing the file when possible. If the format cannot be identified at the time of ingest, it is valid to record that it is unknown, but the repository should subsequently make an effort to identify the format, even if manual intervention is required.
-  #     #
   #     # Rationale: Many preservation activities depend on detailed knowledge about the format of the digital object. An accurate identification of format is essential. The identification provided, whether by name or pointer into a format registry, should be sufficient to associate the object with more detailed format information.
   #     #
+  #     # Usage Notes: A bitstream embedded within a file may have different characteristics than the larger file. For example, a bitstream in LaTex format could be embedded within an SGML file, or multiple images using different colorspaces could be embedded within a TIFF file. format must be recorded for every object. When the bitstream format can be recognized by the repository and the repository might want to treat the bitstream differently from the embedding file for preservation purposes, format can be recorded for embedded bitstreams. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either formatDesignation or formatRegistry) must be present if this container is included or both may be used. If the subunit (formatDesignation or formatRegistry) needs to be repeated, the entire format container is repeated. This allows for association of format designation with a particular set of format registry information. For example, if the precise format cannot be determined and two format designations are recorded, each is given within a separate format container. The format container may also be repeated for multiple format registry entries.
+  #     #
   #     # Definition: Identification of the format of a file or bitstream where format is the organization of digital information according to preset specifications.
+  #     #
+  #     # Creation / Maintenance Notes: The format of a file or bitstream should be ascertained by the repository on ingest. Even if this information is provided by the submitter, directly in metadata or indirectly via the file name extension, recommended practice is to independently identify the format by parsing the file when possible. If the format cannot be identified at the time of ingest, it is valid to record that it is unknown, but the repository should subsequently make an effort to identify the format, even if manual intervention is required.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Format
   #
-  #     # Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. Both may be included. The most specific format (or format profile) should be recorded. A repository (or formats registry) may wish to use multipart format names (e.g., “TIFF_GeoTIFF” or “WAVE_MPEG_BWF”) to achieve this specificity.
-  #     #
   #     # Definition: An identification of the format of the object.
+  #     #
+  #     # Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. Both may be included. The most specific format (or format profile) should be recorded. A repository (or formats registry) may wish to use multipart format names (e.g., “TIFF_GeoTIFF” or “WAVE_MPEG_BWF”) to achieve this specificity.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :FormatDesignation
   #
   #     # Rationale: If central format registries are available to the preservation repository, they may provide an excellent way of referencing detailed format information.
   #     #
-  #     # Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. If more than one formatRegistry needs to be recorded the format container should be repeated to include each additional set of formatRegistry information. The PREMIS working group assumed that a number of format registries will be developed and maintained to support digital preservation efforts. The proposal for a Global Digital Format Registry (GDFR) (http://hul.harvard.edu/gdfr/documents.html#data), for example, would create a network-accessible registry designed to store detailed specifications on formats and profiles.
-  #     #
   #     # Definition: Identifies and/or gives further information about the format by reference to an entry in a format registry.
+  #     #
+  #     # Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. If more than one formatRegistry needs to be recorded the format container should be repeated to include each additional set of formatRegistry information. The PREMIS working group assumed that a number of format registries will be developed and maintained to support digital preservation efforts. The proposal for a Global Digital Format Registry (GDFR) (http://hul.harvard.edu/gdfr/documents.html#data), for example, would create a network-accessible registry designed to store detailed specifications on formats and profiles.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :FormatRegistry
   #
-  #     # Creation / Maintenance Notes: Hardware environment information can be very difficult to provide. Many different hardware environments may apply; there are a huge number of combinations of maker and type of CPU, memory, video drivers, and so on. Although at least one hardware environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which hardware environments to record. Because of the difficulty recording this information comprehensively, it would be optimal if central registries of environment information existed. In many cases the environment of a file object is directly associated with the format, making registry lookup by format feasible. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to hwEnvironment.
-  #     #
   #     # Definition: Hardware components needed by the software referenced in swName or the human user of the referenced software.
+  #     #
+  #     # Creation / Maintenance Notes: Hardware environment information can be very difficult to provide. Many different hardware environments may apply; there are a huge number of combinations of maker and type of CPU, memory, video drivers, and so on. Although at least one hardware environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which hardware environments to record. Because of the difficulty recording this information comprehensively, it would be optimal if central registries of environment information existed. In many cases the environment of a file object is directly associated with the format, making registry lookup by format feasible. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to hwEnvironment.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Hardware
   #
@@ -136,19 +136,19 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Identifier
   #
-  #     # Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.
-  #     #
-  #     # Usage Notes: Some file formats allow encryption for embedded bitstreams. Some file formats such as PDF use passwords to control access to content or specific functions. Although this is actually implemented at the bitstream level, for preservation purposes it is effectively managed at the file level; that is, passwords would not be recorded for individually addressable bitstreams. For certain types of inhibitor keys, more granularity may be required. If the inhibitor key information is identical to key information in digital signatures, use those semantic units.
-  #     #
   #     # Creation / Maintenance Notes: Inhibitors are more likely to be present on an object ingested by the repository than applied by the repository itself. It is often not possible to tell that a file has been encrypted by parsing it; the file may appear to be ASCII text. Therefore, information about inhibitors should be supplied as metadata with submitted objects when possible.
   #     #
   #     # Definition: Features of the object intended to inhibit access, use, or migration.
+  #     #
+  #     # Usage Notes: Some file formats allow encryption for embedded bitstreams. Some file formats such as PDF use passwords to control access to content or specific functions. Although this is actually implemented at the bitstream level, for preservation purposes it is effectively managed at the file level; that is, passwords would not be recorded for individually addressable bitstreams. For certain types of inhibitor keys, more granularity may be required. If the inhibitor key information is identical to key information in digital signatures, use those semantic units.
+  #     #
+  #     # Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Inhibitors
   #
-  #     # Intellectual entities are described via Descriptive metadata models. These are very domain-specific and are out of scope for PREMIS. Examples: Dublin Core, Mets, MARC
-  #     #
   #     # Definition: a set of content that is considered a single intellectual unit for purposes of management and description: for example, a particular book, map, photograph, or database. An Intellectual Entity can include other Intellectual Entities; for example, a Web site can include a Web page; a Web page can include an image. An Intellectual Entity may have one or more digital representations.
+  #     #
+  #     # Intellectual entities are described via Descriptive metadata models. These are very domain-specific and are out of scope for PREMIS. Examples: Dublin Core, Mets, MARC
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :IntellectualEntity
   #
@@ -158,18 +158,18 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :LicenseInformation
   #
+  #     # Entity types:  Representation: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity. File: A named and ordered sequence of bytes that is known to an operating system. Bitstream: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.
+  #     #
   #     # Entity properties: Can be associated with one or more rights statements. Can participate in one or more events. Links between entities may be recorded from either direction and need not be bi-directional.
   #     #
   #     # The object class aggregates information about a digital object held by a preservation repository and describes those characteristics relevant to preservation management. The only mandatory property is objectIdentifier. The object class has three subclasses: Representation, File, and Bitstream.
-  #     #
-  #     # Entity types:  Representation: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity. File: A named and ordered sequence of bytes that is known to an operating system. Bitstream: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Object
   #
-  #     # Usage Notes: The semantic units included in objectCharacteristics should be treated as a set of information that pertains to a single object at a single compositionLevel. Object characteristics may be repeated when an object was created by applying two or more encodings, such as compression and encryption. In this case each repetition of objectCharacteristics would have an incrementally higher compositionLevel. When encryption is applied, the objectCharacteristics block must include an inhibitors semantic unit. A bitstream embedded within a file may have different object characteristics than the file. Where these characteristics are relevant for preservation, they should be recorded. When a single file is equivalent to a representation, objectCharacteristics may be applied and thus associated with the representation. In these cases, the relationship between the file comprising the representation and other associated files may be expressed using relationshipSubType.
-  #     #
   #     # Definition: Technical properties of a file or bitstream that are applicable to all or most formats.
   #     #
+  #     # Usage Notes: The semantic units included in objectCharacteristics should be treated as a set of information that pertains to a single object at a single compositionLevel. Object characteristics may be repeated when an object was created by applying two or more encodings, such as compression and encryption. In this case each repetition of objectCharacteristics would have an incrementally higher compositionLevel. When encryption is applied, the objectCharacteristics block must include an inhibitors semantic unit. A bitstream embedded within a file may have different object characteristics than the file. Where these characteristics are relevant for preservation, they should be recorded. When a single file is equivalent to a representation, objectCharacteristics may be applied and thus associated with the representation. In these cases, the relationship between the file comprising the representation and other associated files may be expressed using relationshipSubType.
+  #     #
   #     # Rationale: There are some important technical properties that apply to objects of any format. Detailed definition of format-specific properties is outside the scope of this Data Dictionary, although such properties may be included within objectCharacteristicsExtension.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :ObjectCharacteristics
@@ -180,11 +180,11 @@ module RDF::Vocab
   #
   #     # Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata. The repository may also choose to record additional metadata indicating the context for the assignment of the preservation level.
   #     #
-  #     # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc. The context surrounding the choice of a particular preservation option for an object may also require further explanation.
+  #     # Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository. Application of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied. The container may be repeated if a preservation level value needs to be recorded in additional contexts (see preservationLevelRole).
   #     #
   #     # Definition: Information indicating the decision or policy on the set of preservation functions to be applied to an object and the context in which the decision or policy was made.
   #     #
-  #     # Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository. Application of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied. The container may be repeated if a preservation level value needs to be recorded in additional contexts (see preservationLevelRole).
+  #     # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc. The context surrounding the choice of a particular preservation option for an object may also require further explanation.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :PreservationLevel
   #
@@ -214,41 +214,41 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :RightsStatement
   #
-  #     # Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.
-  #     #
   #     # Definition: Information needed to use a digital signature to authenticate the signer of an object and/or the information contained in the object.
   #     #
   #     # Usage Notes: Several of the semantic components of signatureInformation are taken from the W3C’s XML-Signature Syntax and Processing; see www.w3.org/TR/2002/REC-xmldsig-core-20020212/ for more information on the structure and application of these semantic units.
+  #     #
+  #     # Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Signature
   #
-  #     # Definition: Characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
-  #     #
-  #     # Rationale: Objects that have the same technical properties may still differ as to the properties that should be preserved for future presentation or use.
-  #     #
   #     # Creation / Maintenance Notes: Significant properties may pertain to all objects of a certain class; for example, the repository can decide that for all PDF files, only the content need be preserved. In other cases, for example, for media art, the significant properties may be unique to each individual object. Where values are unique, they must be supplied by the submitter or provided by the curatorial staff of the repository.
   #     #
   #     # Usage Notes: All of this semantic unit’s subunits are optional. At least one of the significantPropertiesValue and significantPropertiesExtension subunits must be present if this container is included or both may be used. Significant properties may be objective technical characteristics subjectively considered important, or subjectively determined characteristics. For example, a PDF may contain links that are not considered important and JavaScript that is considered important. Or future migrations of a TIFF image may require optimization for line clarity or for color; the option chosen would depend upon a curatorial judgment of the significant properties of the image. Listing significant properties implies that the repository plans to preserve these properties across time and requires them to acceptably survive preservation action; for example, to be maintained during emulation or after format migration. It also implies that the repository would note when preservation action results in modification of significant properties. In practice, significant properties might be used as measures of preservation success, as part of quality checking the results of a preservation action or evaluating the efficacy of a preservation method. For example, if the listed significant properties are not maintained after application of a particular preservation method, it may indicate a failure of the process or that the method is not well suited to the type of material. More experience with digital preservation is needed to determine the best ways of representing significant properties in general, and of representing modification of significant properties. The semantic units included in the significantProperties container aim to provide a flexible structure for describing significant properties, allowing general types of aspects, facets or attributes of an object to be declared and to be paired with specific significant details about the object pertaining to that aspect, facet or attribute. For example, some repositories may define significant properties for objects related to facets of content, appearance, structure, behavior, and context. Examples of facet:detail pairs in this case could include: significantPropertiesType = “content” significantPropertiesValue = “all textual content and images” significantPropertiesType = “behavior” significantPropertiesValue = “editable” Other repositories may choose to describe significant properties at a more granular attribute level; for example: significantPropertiesType = “page count” significantPropertiesValue = “7” significantPropertiesType = “page width” significantPropertiesValue = “210 mm” Each facet:detail pair should be contained in a separate, repeated significantProperties container. Further work on determining and describing significant properties may yield more detailed schemes to facilitate general description. Representing modification of significant properties as a result of preservation action also requires further work. One possible way involves the use of Object and Event information: Object A has significant properties volume and timing, which are recorded as significantProperties of A. In migrated version B, the timing is modified, which is noted in the eventOutcome of the migration event. Only volume is listed as a significant property of B.
+  #     #
+  #     # Rationale: Objects that have the same technical properties may still differ as to the properties that should be preserved for future presentation or use.
+  #     #
+  #     # Definition: Characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :SignificantProperties
   #
-  #     # Creation / Maintenance Notes: If recording this explicitly, many different software environments may apply; for example, a particular object such as a PDF file may be viewable by several versions of several applications running under several operating systems and operating system versions. Although at least one software environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which software environments to record. Also, what appears to the user as a single rendering program can have many dependencies, including system utilities, runtime libraries, and so on, which each might have their own dependencies in turn. As with environment, metadata may be more efficiently managed in conjunction with a format registry either internal or external to a repository. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to software environment.
-  #     #
   #     # Definition: Software required to render or use the object.
+  #     #
+  #     # Creation / Maintenance Notes: If recording this explicitly, many different software environments may apply; for example, a particular object such as a PDF file may be viewable by several versions of several applications running under several operating systems and operating system versions. Although at least one software environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which software environments to record. Also, what appears to the user as a single rendering program can have many dependencies, including system utilities, runtime libraries, and so on, which each might have their own dependencies in turn. As with environment, metadata may be more efficiently managed in conjunction with a format registry either internal or external to a repository. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to software environment.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Software
   #
-  #     # Definition: Information about the statute allowing use of the object.
-  #     #
   #     # Usage Notes: When rights basis is a statute, statuteInformation should be provided.
+  #     #
+  #     # Definition: Information about the statute allowing use of the object.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :StatuteInformation
   #
-  #     # Definition: Information about how and where a file is stored in the storage system.
+  #     # Usage Notes: Normally there would be a single storage location and medium for an object, because an object in another location would be considered a different object. The storage composite should be repeated if there are two or more copies that are identical bit-wise and managed as a unit except for the medium on which they are stored. They must have a single objectIdentifier and be managed as a single object by the repository. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either contentLocation or storageMedium) must be present or both may be used.
   #     #
   #     # Rationale: It is necessary for a repository to associate the contentLocation with the storageMedium.
   #     #
-  #     # Usage Notes: Normally there would be a single storage location and medium for an object, because an object in another location would be considered a different object. The storage composite should be repeated if there are two or more copies that are identical bit-wise and managed as a unit except for the medium on which they are stored. They must have a single objectIdentifier and be managed as a single object by the repository. Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either contentLocation or storageMedium) must be present or both may be used.
+  #     # Definition: Information about how and where a file is stored in the storage system.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :Storage
   #
@@ -264,10 +264,10 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :TermOfRestriction
   #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/actionsGranted 
-  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/actionsGranted 
+  #     #
   #     # Definition: The action the preservation repository is allowed to take.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasAct
@@ -278,13 +278,13 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasAgent
   #
-  #     # Usage Note: The value is not necessarily unique.
-  #     #
-  #     # Definition: A text string which could be used in addition to agentIdentifier to identify an agent.
+  #     # Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.
   #     #
   #     # Examples: Erik Owens, Pc
   #     #
-  #     # Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.
+  #     # Definition: A text string which could be used in addition to agentIdentifier to identify an agent.
+  #     #
+  #     # Usage Note: The value is not necessarily unique.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasAgentName
   #
@@ -294,10 +294,10 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasAgentNote
   #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/agentType 
-  #     #
   #     # Definition: A high-level characterization of the type of agent.
   #     #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/agentType 
+  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasAgentType
@@ -305,38 +305,38 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasApplicableDates
   #
-  #     # Examples: 0, 1, 2
-  #     #
-  #     # Data Constraints: Non-negative integers.
-  #     #
   #     # Usage Notes: A file or bitstream can be subject to multiple encodings that must be decoded in reverse order (highest to lowest). For example, file A may be compressed to create file B, which is encrypted to create file C. To recreate a copy of the base file A, one would have to unencrypt file C to create file B and then uncompress file B to create file A. A compositionLevel of zero indicates that the object is a base object and not subject to further decoding, while a level of 1 or higher indicates that one or more decodings must be applied. Numbering goes lowest to highest (first encoded = 0). 0 is base object; 1-n are subsequent encodings. Use 0 as the default if there is only one compositionLevel. When multiple file objects are bundled together as filestreams within a package file object (e.g., a ZIP file), the individual filestream objects are not composition levels of the package file object. They should be considered separate objects, each with their own composition levels. For example, two encrypted files zipped together and stored in an archive as one file object would be described as three separate objects, each with its own associated metadata. The storage location of the two inner objects would point to the ZIP file, but the ZIP file itself would have only a single composition level (of zero) whose format would be “zip.”
   #     #
+  #     # Examples: 0, 1, 2
+  #     #
   #     # Creation / Maintenance Notes: Composition level will generally be supplied by the repository, which should attempt to supply this value automatically. If the object was created by the repository, the creating routine knows the composition level and can supply this metadata. If the object is being ingested by the repository, repository programs will have to attempt to identify the composition level from the object itself or from externally supplied metadata.
   #     #
   #     # Definition: An indication of whether the object is subject to one or more processes of decoding or unbundling.
   #     #
   #     # Rationale: A file or bitstream can be encoded with compression, encryption, etc., or bundled with other files or bitstreams into larger packages. Knowing the order in which these actions are taken is important if the original object or objects must be recovered.
+  #     #
+  #     # Data Constraints: Non-negative integers.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasCompositionLevel
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasContentLocation
   #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType
+  #     #
   #     # Definition: The means of referencing the location of the content.
   #     #
   #     # Rationale: To understand the meaning of the value it is necessary to know what location scheme is used.
   #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
-  #     #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasContentLocationType
   #
-  #     # Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ (file), c:\apache2\htdocs\index.html (file), 64 [offset from start of file c:\apache2\htdocs\image\logo.gif] (bitstream)
+  #     # Definition: The reference to the location of the content used by the storage system.
   #     #
   #     # Usage Notes: This could be a fully qualified path and filename, or the information used by a resolution system (e.g., a handle) or the native information used by a storage management system. For a bitstream or filestream, this would probably be the reference point and offset of the starting position of the bitstream. It is up to the repository to determine the level of granularity that should be recorded.
   #     #
-  #     # Definition: The reference to the location of the content used by the storage system.
+  #     # Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ (file), c:\apache2\htdocs\index.html (file), 64 [offset from start of file c:\apache2\htdocs\image\logo.gif] (bitstream)
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasContentLocationValue
   #
@@ -350,19 +350,19 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasCopyrightJurisdiction
   #
-  #     # Definition: A coded designation for the copyright status of the object at the time the rights statement is recorded.
-  #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/copyrightStatus
   #     #
+  #     # Definition: A coded designation for the copyright status of the object at the time the rights statement is recorded.
+  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasCopyrightStatus
   #
+  #     # Example: 2001-10-26T19:32:52+00:00
+  #     #
   #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
   #     #
   #     # Definition: The date that the copyright status recorded in copyrightStatus was determined.
-  #     #
-  #     # Example: 2001-10-26T19:32:52+00:00
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasCopyrightStatusDeterminationDate
   #
@@ -383,65 +383,65 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasCreatingApplicationVersion
   #
-  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
-  #     #
-  #     # Usage Notes: Use the most precise date available. This is the date the object was created by the creating application, not the date any copy was made externally or by the repository. For example, if a file is created by Microsoft Word in 2001 and two copies are made in 2003, the dateCreatedByApplication of all three files is 2001. The date a file is written to storage can be recorded as an Event. If the object itself contains internal creation and modification dates, the modification date should be used as dateCreatedByApplication. If the application is a Web harvester capturing an object at a point of time, use for date captured.
-  #     #
   #     # Example: 2001-10-26T19:32:52+00:00
   #     #
+  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
+  #     #
   #     # Definition: The actual or approximate date and time the object was created.
+  #     #
+  #     # Usage Notes: Use the most precise date available. This is the date the object was created by the creating application, not the date any copy was made externally or by the repository. For example, if a file is created by Microsoft Word in 2001 and two copies are made in 2003, the dateCreatedByApplication of all three files is 2001. The date a file is written to storage can be recorded as an Event. If the object itself contains internal creation and modification dates, the modification date should be used as dateCreatedByApplication. If the application is a Web harvester capturing an object at a point of time, use for date captured.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasDateCreatedByApplication
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasDependency
   #
+  #     # Example: Additional Element Set for Language Corpora
+  #     #
   #     # Definition: A designation for a component or associated file needed by the representation or file.
   #     #
   #     # Rationale: It may not be self-evident from the dependencyIdentifier what the name of the object actually is.
-  #     #
-  #     # Example: Additional Element Set for Language Corpora
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasDependencyName
   #
   #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
   #     #
-  #     # Usage Notes: Use “0000-00-00T00:00:00+00:00” for an open ended term of grant. Omit endDate if the ending date is unknown or the permission statement applies to many objects with different end dates.
-  #     #
   #     # Definition: The ending date of the permission granted.
+  #     #
+  #     # Usage Notes: Use “0000-00-00T00:00:00+00:00” for an open ended term of grant. Omit endDate if the ending date is unknown or the permission statement applies to many objects with different end dates.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEndDate
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEnvironment
   #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentCharacteristic
-  #     #
   #     # Rationale: If multiple environments are described, this element can help to distinguish among them.
   #     #
+  #     # Definition: An assessment of the extent to which the described environment supports its purpose.
+  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
-  #     # Definition: An assessment of the extent to which the described environment supports its purpose.
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentCharacteristic
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEnvironmentCharacteristic
   #
-  #     # Definition: Additional information about the environment.
+  #     # Usage Notes: This note could be used to record the context of the environment information. For example, if a file can be rendered through a PC client application or through a browser with a plug-in, this note could be used to identify which situation applies. The note should not be used for a textual description of environment information recorded more rigorously elsewhere.
   #     #
   #     # Rationale: There may be a need to give a textual description of the environment for additional explanation.
   #     #
-  #     # Usage Notes: This note could be used to record the context of the environment information. For example, if a file can be rendered through a PC client application or through a browser with a plug-in, this note could be used to identify which situation applies. The note should not be used for a textual description of environment information recorded more rigorously elsewhere.
-  #     #
   #     # Example: This environment assumes that the PDF will be stored locally and used with a standalone PDF reader.
+  #     #
+  #     # Definition: Additional information about the environment.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEnvironmentNote
   #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
+  #     # Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.
+  #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentPurpose
   #     #
   #     # Definition: The use(s) supported by the specified environment.
-  #     #
-  #     # Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEnvironmentPurpose
   #
@@ -451,33 +451,33 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEvent
   #
-  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
-  #     #
-  #     # Definition: The single date and time, or date and time range, at or during which the event occurred.
+  #     # Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.
   #     #
   #     # Example: 2001-10-26T19:32:52+00:00
   #     #
-  #     # Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.
+  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
+  #     #
+  #     # Definition: The single date and time, or date and time range, at or during which the event occurred.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventDateTime
   #
-  #     # Definition: Additional information about the event.
-  #     #
   #     # Examples: Object permanently withdrawn by request of Caroline Hunt,  Program=“MIGJP2JP2K”; version=“2.2”
   #     #
   #     # Usage Notes: eventDetail is not intended to be processed by machine. It may record any information about an event and/or point to information stored elsewhere.
+  #     #
+  #     # Definition: Additional information about the event.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventDetail
   #
-  #     # Usage Notes: Recommended practice is to use a controlled vocabulary that a system can act upon automatically. More detail about the outcome may be recorded in eventOutcomeDetail. Recommended practice is to define events with sufficient granularity that each event has a single outcome.
-  #     #
-  #     # Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.
-  #     #
   #     # Data Constraint: Value should be taken from a controlled vocabulary.
   #     #
+  #     # Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]
+  #     #
   #     # Definition: A categorization of the overall result of the event in terms of success, partial success, or failure.
   #     #
-  #     # Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]
+  #     # Usage Notes: Recommended practice is to use a controlled vocabulary that a system can act upon automatically. More detail about the outcome may be recorded in eventOutcomeDetail. Recommended practice is to define events with sufficient granularity that each event has a single outcome.
+  #     #
+  #     # Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventOutcome
   #
@@ -501,21 +501,21 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventRelatedAgent
   #
-  #     # Rationale: Digital provenance often requires that relationships between objects and events are documented.
-  #     #
   #     # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
   #     #
   #     # Definition: Information about an object associated with an event.
+  #     #
+  #     # Rationale: Digital provenance often requires that relationships between objects and events are documented.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventRelatedObject
   #
-  #     # Rationale: Categorizing events will aid the preservation repository in machine processing of event information, particularly in reporting.
+  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Definition: A categorization of the nature of the event.
   #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/eventType
   #     #
-  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     # Rationale: Categorizing events will aid the preservation repository in machine processing of event information, particularly in reporting.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasEventType
   #
@@ -528,23 +528,23 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatDesignation
   #
-  #     # Definition: A designation of the format of the file or bitstream.
-  #     #
   #     # Data Constraint: Value should be taken from a controlled vocabulary.
   #     #
   #     # Examples: Text/sgml, image/tiff/geotiff, Adobe PDF, DES, PGP, base64, unknown, LaTex
   #     #
+  #     # Definition: A designation of the format of the file or bitstream.
+  #     #
   #     # Usage Notes: For unidentified formats, formatName may be recorded as “unknown”.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatName
   #
-  #     # Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.
-  #     #
-  #     # Usage Notes: The formatNote may contain free text, a reference pointer, or a value from a controlled list.
-  #     #
   #     # Definition: Additional information about format.
   #     #
   #     # Examples: tentative identification, disjunction, multiple format identifications found
+  #     #
+  #     # Usage Notes: The formatNote may contain free text, a reference pointer, or a value from a controlled list.
+  #     #
+  #     # Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatNote
   #
@@ -565,23 +565,23 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatRegistryName
   #
-  #     # Definition: The purpose or expected use of the registry.
-  #     #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/formatRegistryRole
-  #     #
   #     # Rationale: The same format may be defined in different registries for different purposes. For example, one registry may give detailed format specifications while another has profile information. If multiple registries are recorded, this semantic unit can be used to distinguish among them.
   #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/formatRegistryRole
+  #     #
+  #     # Definition: The purpose or expected use of the registry.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatRegistryRole
   #
-  #     # Examples: 6.0, 2003
+  #     # Definition: The version of the format named in formatName.
   #     #
   #     # Usage Notes: If the format is versioned, formatVersion should be recorded. It can be either a numeric or chronological designation.
   #     #
   #     # Rationale: Many authority lists of format names are not granular enough to indicate version, for example, MIME Media types.
   #     #
-  #     # Definition: The version of the format named in formatName.
+  #     # Examples: 6.0, 2003
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasFormatVersion
   #
@@ -596,36 +596,36 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasHardwareName
   #
-  #     # Definition: Additional requirements or instructions related to the hardware referenced in hwName.
-  #     #
-  #     # Usage Notes: This could be an identifier or URI used to point to hardware documentation.
-  #     #
   #     # Examples: 32MB minimum, Required RAM for Apache is unknown
   #     #
+  #     # Definition: Additional requirements or instructions related to the hardware referenced in hwName.
+  #     #
   #     # Rationale: For hardware, the amount of computing resource needed (such as memory, storage, processor speed, etc.) may need to be documented. In addition, more detailed instructions may be needed to install and/or operate the hardware.
+  #     #
+  #     # Usage Notes: This could be an identifier or URI used to point to hardware documentation.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasHardwareOtherInformation
   #
-  #     # Definition: Class or category of the hardware.
+  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/hardwareType
   #     #
-  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     # Definition: Class or category of the hardware.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasHardwareType
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasIdentifier
   #
+  #     # Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.
+  #     #
   #     # Data Constraint: Value should be taken from controlled vocabulary.
   #     #
+  #     # Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.
+  #     #
   #     # Definition: A designation of the domain within which the identifier is unique.
   #     #
   #     # Examples: DLC, DRS, hdl:4263537
-  #     #
-  #     # Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.
-  #     #
-  #     # Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasIdentifierType
   #
@@ -635,19 +635,19 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasIdentifierValue
   #
-  #     # Example: [DES decryption key]
+  #     # Definition: The decryption key or password.
   #     #
   #     # Usage Notes: The key should be provided if known. However, it is not advisable to actually store the inhibitorKey in plain text in an unsecure database.
   #     #
-  #     # Definition: The decryption key or password.
+  #     # Example: [DES decryption key]
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasInhibitorKey
   #
+  #     # Definition: The content or function protected by the inhibitor.
+  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorTarget
-  #     #
-  #     # Definition: The content or function protected by the inhibitor.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasInhibitorTarget
   #
@@ -671,28 +671,30 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasKeyInformation
   #
-  #     # Definition: Text describing the license or agreement by which permission was granted.
-  #     #
   #     # Usage Notes: This could contain the actual text of the license or agreement or a paraphrase or summary.
+  #     #
+  #     # Definition: Text describing the license or agreement by which permission was granted.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasLicenseTerms
   #
+  #     # Rationale: This must be stored so that it can be compared in future fixity checks.
+  #     #
   #     # Definition: The output of the message digest algorithm.
   #     #
   #     # Example: 7c9b35da4f2ebd436f1cf88e5a39b3a257edf4a22be3c955ac49da2e2107b67a1924419563
-  #     #
-  #     # Rationale: This must be stored so that it can be compared in future fixity checks.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasMessageDigest
   #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions
+  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Definition: The specific algorithm used to construct the message digest for the digital object.
-  #     #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasMessageDigestAlgorithm
   #
+  #     # Definition: The agent that created the original message digest that is compared in a fixity check.
+  #     #
   #     # Examples: DRS, A0000978
   #     #
   #     # Usage Notes: The originator of the message digest could be represented by a string representing the agent (e.g., “NRS” referring to the archive itself) or a pointer to an agent description (e.g., “A0000987” taken here to be an agentIdentifierValue).
@@ -700,15 +702,13 @@ module RDF::Vocab
   #     # Rationale: A preservation repository may ingest files that have had message digests calculated by the submitter; checking these ensures that the file as received is the same as the file as sent. The repository may also ingest files that do not have message digests, and so must calculate the initial value upon ingest. It can be useful to know who calculated the initial value of the message digest.
   #     #
   #     # Creation / Maintenance Notes: If the calculation of the initial message digest is treated by the repository as an Event, this information could be obtained from an Event record.
-  #     #
-  #     # Definition: The agent that created the original message digest that is compared in a fixity check.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasMessageDigestOriginator
   #
-  #     # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
-  #     #
   #     # Rationale: Digital provenance often requires that relationships between objects and events are documented. / Rights statements must be associated with the objects to which they pertain, either by linking from the rights statement to the object(s) or by linking from the object(s) to the rights statement. This provides the mechanism for the link from the rights statement to an object. For denoting the role of the object, when related to an event,one can extend this ontology be defining your own subproperties, such as those given by http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole.
   #     #
+  #     # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
+  #     #
   #     # Definition: Information about an object associated with an event or rightsstatement.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasObject
@@ -718,35 +718,35 @@ module RDF::Vocab
   #
   #     # Creation / Maintenance Notes: This value would always be supplied to the repository by the submitter or harvesting application. How much of the file path to preserve would be up to the repository.
   #     #
-  #     # Definition: The name of the object as submitted to or harvested by the repository, before any renaming by the repository.
-  #     #
-  #     # Rationale: The name used within the preservation repository may not be known outside of the repository. A depositor might need to request a file by its original name. Also, the repository may need to reconstruct internal links for dissemination.
-  #     #
   #     # Usage Notes: This is the name of the object as designated in the Submission Information Package (SIP). The object may have other names in different contexts. When two repositories are exchanging content, it would be important for the receiving repository to know and record the name of the representation at the originating repository. In the case of representations, this may be a directory name.
   #     #
+  #     # Definition: The name of the object as submitted to or harvested by the repository, before any renaming by the repository.
+  #     #
   #     # Example: N419.pdf
+  #     #
+  #     # Rationale: The name used within the preservation repository may not be known outside of the repository. A depositor might need to request a file by its original name. Also, the repository may need to reconstruct internal links for dissemination.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasOriginalName
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasPreservationLevel
   #
-  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
-  #     #
   #     # Definition: The date, or date and time, when a particular preservationLevelValue was assigned to the object.
   #     #
-  #     # Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.
-  #     #
   #     # Examples: 2001-10-26T19:32:52+00:00
+  #     #
+  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
+  #     #
+  #     # Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasPreservationLevelDateAssigned
   #
-  #     # Usage Notes: This optional semantic unit records the reason for applying the preservationLevelValue. This information can be particularly important when the assigned preservationLevelValue differs from usual repository policy. For example, a repository may normally assign a preservationLevelValue of “full preservation” for JPEG2000 files, but detects that a particular file is defective. This may mean that the repository’s preservation strategy for JPEG2000 may not be effective for this particular file, so the repository may assign a preservationLevelValue of “bit-level preservation” to this file, recording “defective file” as the rationale. Similarly, legislative requirements or contractual agreements may require a higher level of preservation to be assigned to a particular object than would be assigned to that class of object according to usual policy. In this case, the rationale for the assignment may be recorded as “legislation” or “user pays”, for example. preservationLevelRationale may be repeated if more than one reason needs to be recorded.
-  #     #
   #     # Definition: The reason a particular preservationLevelValue was applied to      the object.
   #     #
   #     # Examples: user pays, legislation, defective file, bit-level preservation only available for this format
   #     #
+  #     # Usage Notes: This optional semantic unit records the reason for applying the preservationLevelValue. This information can be particularly important when the assigned preservationLevelValue differs from usual repository policy. For example, a repository may normally assign a preservationLevelValue of “full preservation” for JPEG2000 files, but detects that a particular file is defective. This may mean that the repository’s preservation strategy for JPEG2000 may not be effective for this particular file, so the repository may assign a preservationLevelValue of “bit-level preservation” to this file, recording “defective file” as the rationale. Similarly, legislative requirements or contractual agreements may require a higher level of preservation to be assigned to a particular object than would be assigned to that class of object according to usual policy. In this case, the rationale for the assignment may be recorded as “legislation” or “user pays”, for example. preservationLevelRationale may be repeated if more than one reason needs to be recorded.
+  #     #
   #     # Rationale: Application of a particular preservationLevelValue may require justification, especially if it differs from that usually applied according to repository policy.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasPreservationLevelRationale
@@ -755,23 +755,23 @@ module RDF::Vocab
   #     #
   #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/preservationLevelRole
   #     #
-  #     # Rationale: Repositories may assign preservationLevelValues in different contexts which must be differentiated, and may need to record more than one context.
-  #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     #
+  #     # Rationale: Repositories may assign preservationLevelValues in different contexts which must be differentiated, and may need to record more than one context.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasPreservationLevelRole
   #
-  #     # Usage Notes: Only one preservationLevelValue may be recorded per preservationLevel container. If a further preservationLevelValue applies to the object in a different context, a separate preservationLevel container should be repeated.
+  #     # Data Constraint: Value should be taken from a controlled vocabulary.
   #     #
   #     # Examples: bit-level, full, fully supported with future migrations (File), 0
   #     #
-  #     # Data Constraint: Value should be taken from a controlled vocabulary.
+  #     # Usage Notes: Only one preservationLevelValue may be recorded per preservationLevel container. If a further preservationLevelValue applies to the object in a different context, a separate preservationLevel container should be repeated.
+  #     #
+  #     # Definition: A value indicating the set of preservation functions expected to be applied to the object.
   #     #
   #     # Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc.
   #     #
   #     # Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata.
-  #     #
-  #     # Definition: A value indicating the set of preservation functions expected to be applied to the object.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasPreservationLevelValue
   #
@@ -789,10 +789,10 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRelatedStatuteInformation
   #
-  #     # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
-  #     #
   #     # The LOC will provide a SKOS vocabulary, where the concepts can also be used as object properties at http://id.loc.gov/. These relationships will capture the relationship type and subtype. One can define its own relationships, but for interoperability reasons, these should be linked to or made a subproperty of the properties of the LOC vocabulary.
   #     #
+  #     # Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.
+  #     #
   #     # Definition: This property links one object to one or more other objects.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRelationship
@@ -815,11 +815,11 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRightsGranted
   #
+  #     # Rationale: A textual description of the rights granted may be needed for additional explanation.
+  #     #
   #     # Usage Notes: This semantic unit may include a statement about risk assessment, for example, when a repository is not certain about what permissions have been granted.
   #     #
   #     # Definition: Additional information about the rights granted.
-  #     #
-  #     # Rationale: A textual description of the rights granted may be needed for additional explanation.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRightsGrantedNote
   #
@@ -829,9 +829,9 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRightsRelatedAgent
   #
-  #     # Rationale: A repository may choose to link from a rights statement to an object or from an object to a rights statement or both.
-  #     #
   #     # Definition: A rights statement associated with the object.
+  #     #
+  #     # Rationale: A repository may choose to link from a rights statement to an object or from an object to a rights statement or both.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasRightsStatement
   #
@@ -844,23 +844,23 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignature
   #
-  #     # Definition: The encoding used for the values of signatureValue, keyInformation.
-  #     #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/signatureEncoding
-  #     #
   #     # Rationale: These values cannot be interpreted correctly if the encoding is unknown.
   #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/signatureEncoding
+  #     #
+  #     # Definition: The encoding used for the values of signatureValue, keyInformation.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignatureEncoding
   #
-  #     # Rationale: The same algorithms must be used for signature validation.
+  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Data Constraint: Values are taken from a SKOS vocabulary
   #     #
-  #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
-  #     #
   #     # Definition: A designation for the encryption and hash algorithms used for signature generation.
+  #     #
+  #     # Rationale: The same algorithms must be used for signature validation.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignatureMethod
   #
@@ -870,17 +870,17 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignatureProperties
   #
-  #     # Definition: The operations to be performed in order to validate the digital signature.
-  #     #
   #     # Usage Notes: This may include the canonicalization method used before calculating the message digest, if the object was normalized before signing. This value could also be a pointer to archive documentation.
   #     #
   #     # Rationale: The repository should not assume that the procedure for validating any particular signature will be known many years in the future without documentation.
+  #     #
+  #     # Definition: The operations to be performed in order to validate the digital signature.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignatureValidationRules
   #
-  #     # Definition: The digital signature; a value generated from the application of a private key to a message digest.
-  #     #
   #     # Example: juS5RhJ884qoFR8flVXd/rbrSDVGn40CapgB7qeQiT+rr0NekEQ6BHhUA8dT3+BCTBUQI0dBjlml9lwzENXvS83zRECjzXbMRTUtVZiPZG2pqKPnL2YU3A9645UCjTXU+jgFumv7k78hieAGDzNci+PQ9KRmm//icT7JaYztgt4=
+  #     #
+  #     # Definition: The digital signature; a value generated from the application of a private key to a message digest.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignatureValue
   #
@@ -895,32 +895,32 @@ module RDF::Vocab
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignificantProperties
   #
-  #     # Definition: The aspect, facet, or attribute of an object about which significant properties are being described.
-  #     #
-  #     # Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.
+  #     # Examples: content, structure, behavior, page count, page width, typeface, hyperlinks (representation), image count (representation), color space [for an embedded image] (bitstream)
   #     #
   #     # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
   #     #
-  #     # Examples: content, structure, behavior, page count, page width, typeface, hyperlinks (representation), image count (representation), color space [for an embedded image] (bitstream)
+  #     # Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.
+  #     #
+  #     # Definition: The aspect, facet, or attribute of an object about which significant properties are being described.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignificantPropertiesType
   #
-  #     # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
-  #     #
-  #     # Examples: [For a Web page containing animation that is not considered essential] Content only, [For detail associated with a significantPropertiesType of "behavior"] Hyperlinks traversable, [For a Word document with embedded links that are not considered essential] Content only, [For detail associated with significantPropertiesType of "behavior"] Editable, [For detail associated with a significantPropertiesType of "page width"] 210 mm, [For a PDF with an embedded graph, where the lines' color determines the lines' meaning] Color, [For detail associated with a significantPropertiesType of "appearance"] Color
+  #     # Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
   #     #
   #     # Usage Notes: If facet:detail pairs are used, the content of significantPropertiesValue should describe the significant properties of object relevant to the aspect, facet, or attribute declared in the significantPropertiesType with which it is paired. If facet:detail pairs are not used, significantPropertiesValue may be used to freely describe any characteristic of an object. significantPropertiesValue is not repeatable. Multiple significant properties should be described in separate, repeated significantProperties container units.
   #     #
-  #     # Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.
+  #     # Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.
+  #     #
+  #     # Examples: [For a Web page containing animation that is not considered essential] Content only, [For detail associated with a significantPropertiesType of "behavior"] Hyperlinks traversable, [For a Word document with embedded links that are not considered essential] Content only, [For detail associated with significantPropertiesType of "behavior"] Editable, [For detail associated with a significantPropertiesType of "page width"] 210 mm, [For a PDF with an embedded graph, where the lines' color determines the lines' meaning] Color, [For detail associated with a significantPropertiesType of "appearance"] Color
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSignificantPropertiesValue
   #
-  #     # Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.
-  #     #
   #     # Definition: The size in bytes of the file or bitstream stored in the repository.
   #     #
   #     # Creation / Maintenance Notes: Automatically obtained by the repository.
   #     #
+  #     # Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.
+  #     #
   #     # Example: 2038937
   #     #
   #     # Rationale: Size is useful for ensuring the correct number of bytes from storage have been retrieved and that an application has enough room to move or process files. It might also be used when billing for storage.
@@ -932,66 +932,66 @@ module RDF::Vocab
   #
   #     # Definition: The name and, if applicable, version of any software component needed by the software referenced in swName in the context of using this object.
   #     #
-  #     # Usage Notes: The value should be constructed in a way that is consistent with the construction of swName and swVersion. This semantic unit identifies the software that is needed by what is recorded in swName, for example, a Perl script that depends on a Perl module. In this case the Perl script is listed in swName, with the module in swDependency within a software container.
-  #     #
   #     # Example: GNU gcc >=2.7.2
+  #     #
+  #     # Usage Notes: The value should be constructed in a way that is consistent with the construction of swName and swVersion. This semantic unit identifies the software that is needed by what is recorded in swName, for example, a Perl script that depends on a Perl module. In this case the Perl script is listed in swName, with the module in swDependency within a software container.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSoftwareDependency
   #
-  #     # Definition: Manufacturer and title of the software application.
-  #     #
   #     # Usage Notes: Include manufacturer when this helps to identify or disambiguate the product, for example, use “Adobe Photoshop” rather than “Photoshop.”
   #     #
   #     # Examples: Adobe Photoshop, Adobe Acrobat Reader
+  #     #
+  #     # Definition: Manufacturer and title of the software application.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSoftwareName
   #
   #     # Definition: Additional requirements or instructions related to the software referenced in swName.
   #     #
-  #     # Example: Install Acroread (Adobe Acrobat) first; copy nppdf.so (the plug-in) to your Mozilla plug-ins directory, and make sure a copy of (or symlink to) Acroread is in your PATH.
-  #     #
   #     # Usage Notes: This could be a reliable persistent identifier or URI pointing to software documentation within or outside the repository.
+  #     #
+  #     # Example: Install Acroread (Adobe Acrobat) first; copy nppdf.so (the plug-in) to your Mozilla plug-ins directory, and make sure a copy of (or symlink to) Acroread is in your PATH.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSoftwareOtherInformation
   #
-  #     # Rationale: Several different layers of software can be required to support an object.
-  #     #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/softwareType
-  #     #
   #     # Definition: Class or category of software.
   #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
+  #     #
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/softwareType
+  #     #
+  #     # Rationale: Several different layers of software can be required to support an object.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSoftwareType
   #
-  #     # Usage Notes: If there is no formal version, the date of issuance can be used.
-  #     #
   #     # Definition: The version or versions of the software referenced in swName.
   #     #
   #     # Examples: >=2.2.0, 6.0, 2003
+  #     #
+  #     # Usage Notes: If there is no formal version, the date of issuance can be used.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasSoftwareVersion
   #
-  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
-  #     #
   #     # Definition: The beginning date of the permission granted.
+  #     #
+  #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStartDate
   #
-  #     # Definition: An identifying designation for the statute.
-  #     #
   #     # Usage Notes: Use standard citation form when applicable.
   #     #
+  #     # Definition: An identifying designation for the statute.
+  #     #
   #     # Examples: Legal Deposit (Jersey) Law 200, National Library of New Zealand (Te Puna Mātauranga o Aotearoa) Act 2003 no 19 part 4 s 34
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStatuteCitation
   #
+  #     # Example: 2001-10-26T19:32:52+00:00
+  #     #
   #     # Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime
   #     #
   #     # Rationale: The permission in question may be the subject of some interpretation. These assessments are made within a specific context and at a specific time. At another time the context, and therefore the assessment, could change. For this reason it can be important to record the date of the decision.
   #     #
-  #     # Example: 2001-10-26T19:32:52+00:00
-  #     #
   #     # Definition: The date that the determination was made that the statute authorized the permission(s) noted.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStatuteInformationDeterminationDate
@@ -1000,22 +1000,22 @@ module RDF::Vocab
   #     #
   #     # Definition: The country or other political body enacting the statute.
   #     #
-  #     # Rationale: The connection between the object and the rights granted is based on jurisdiction.
-  #     #
   #     # Examples: us, de, be
+  #     #
+  #     # Rationale: The connection between the object and the rights granted is based on jurisdiction.
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStatuteJurisdiction
   #
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStorage
   #
-  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium
+  #     # Definition: The physical medium on which the object is stored (e.g., magnetic tape, hard disk, CD-ROM, DVD).
   #     #
   #     # Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.
   #     #
   #     # Rationale: The repository needs to know the medium on which an object is stored in order to know how and when to do media refreshment and media migration.
   #     #
-  #     # Definition: The physical medium on which the object is stored (e.g., magnetic tape, hard disk, CD-ROM, DVD).
+  #     # Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium
   #     # @return [RDF::Vocabulary::Term]
   #     attr_reader :hasStorageMedium
   #
@@ -1030,9 +1030,7 @@ module RDF::Vocab
 
     # Ontology definition
     ontology :"http://www.loc.gov/premis/rdf/v1#",
-      comment: %(
-        This ontology identifies the classes and properties used to describe preservation metadata in RDF.
-        It aligns with PREMIS Data Dictionary version 2.2.).freeze,
+      comment: "\n        This ontology identifies the classes and properties used to describe preservation metadata in RDF.\n        It aligns with PREMIS Data Dictionary version 2.2.".freeze,
       "dc:modified": "2012-09-14T00:00:00Z".freeze,
       isDefinedBy: "http://www.loc.gov/standards/premis/v2/premis-2-2.pdf".freeze,
       label: "Preservation Metadata: Implementation Strategies (PREMIS) Ontology".freeze,
@@ -1043,17 +1041,12 @@ module RDF::Vocab
 
     # Class definitions
     term :Agent,
-      comment: [%(Entity properties:
-May hold or grant one or more rights.
-May carry out, authorize, or compel one or more events.
-May create or act upon one or more objects through an event or with respect to a rights statement.).freeze, %(The Agent entity aggregates information about attributes or characteristics of agents \(persons, organizations, or software\) associated with rights management and preservation events in the life of a data object. Agent information serves to identify an agent unambiguously from all other
-Agent entities.).freeze],
+      comment: ["Entity properties:\nMay hold or grant one or more rights.\nMay carry out, authorize, or compel one or more events.\nMay create or act upon one or more objects through an event or with respect to a rights statement.".freeze, "The Agent entity aggregates information about attributes or characteristics of agents (persons, organizations, or software) associated with rights management and preservation events in the life of a data object. Agent information serves to identify an agent unambiguously from all other\nAgent entities.".freeze],
       subClassOf: ["dc:Agent".freeze, "foaf:Agent".freeze, "premis:PremisEntity".freeze],
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :ApplicableDates,
-      comment: [%(Definition: The date range during which the particular rights statement applies or is
-applied to the content.).freeze, %(Rationale Specific dates may apply to the particular rights statement.).freeze],
+      comment: ["Definition: The date range during which the particular rights statement applies or is\napplied to the content.".freeze, "Rationale Specific dates may apply to the particular rights statement.".freeze],
       subClassOf: [term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasEndDate".freeze,
@@ -1066,7 +1059,7 @@ applied to the content.).freeze, %(Rationale Specific dates may apply to the par
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Bitstream,
-      comment: %(Definition: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.).freeze,
+      comment: "Definition: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.".freeze,
       "rdfs:seeAlso": "Object class definition".freeze,
       subClassOf: ["premis:Object".freeze, term(
           minCardinality: "1".freeze,
@@ -1076,7 +1069,7 @@ applied to the content.).freeze, %(Rationale Specific dates may apply to the par
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :ContentLocation,
-      comment: [%(Creation / Maintenance Notes: A preservation repository should never refer to content that it does not control. Therefore, the PREMIS working group assumed that the repository will always assign the contentLocation, probably by program.).freeze, %(Definition: Information needed to retrieve a file from the storage system, or to access a bitstream within a file.).freeze, %(Usage Notes: If the preservation repository uses the objectIdentifier as a handle for retrieving data, contentLocation is implicit and does not need to be recorded.).freeze],
+      comment: ["Creation / Maintenance Notes: A preservation repository should never refer to content that it does not control. Therefore, the PREMIS working group assumed that the repository will always assign the contentLocation, probably by program.".freeze, "Definition: Information needed to retrieve a file from the storage system, or to access a bitstream within a file.".freeze, "Usage Notes: If the preservation repository uses the objectIdentifier as a handle for retrieving data, contentLocation is implicit and does not need to be recorded.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1092,8 +1085,7 @@ applied to the content.).freeze, %(Rationale Specific dates may apply to the par
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :CopyrightInformation,
-      comment: [%(Definition: Information about the copyright status of the object\(s\).).freeze, %(Usage Notes: When rights basis is a copyright, copyrightInformation should be provided.
-Repositories may need to extend this with more detailed information. See the California Digital Library's copyrightMD schema \(www.cdlib.org/inside/projects/rights/schema/\) for an example of a more detailed scheme.).freeze],
+      comment: ["Definition: Information about the copyright status of the object(s).".freeze, "Usage Notes: When rights basis is a copyright, copyrightInformation should be provided.\nRepositories may need to extend this with more detailed information. See the California Digital Library's copyrightMD schema (www.cdlib.org/inside/projects/rights/schema/) for an example of a more detailed scheme.".freeze],
       subClassOf: ["premis:RightsStatement".freeze, term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1109,12 +1101,7 @@ Repositories may need to extend this with more detailed information. See the Cal
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :CreatingApplication,
-      comment: [%(Creation / Maintenance Notes: If the object was created by the repository, assignment of creating application information should be straightforward.
-If the object was created outside the repository, it is possible this information could be supplied by the depositor. It might also be extracted from the file itself; the name of the creating application is often embedded within the file.).freeze, %(Definition: Information about the application that created the object.).freeze, %(Rationale: Information about the creating application, including the version of the application and the date the file was created, can be useful for problem solving purposes. For example, it is not uncommon for certain versions of software to be known for causing conversion errors or introducing artifacts. It is also useful to determine which rendering software is available for the digital object. For example, if you know that the Distiller program created the PDF file, you know it will be renderable with \(among other programs\) Adobe Reader.).freeze, %(Usage Notes: This semantic unit applies to both objects created external to the repository and subsequently ingested, and to objects created by the repository, for example, through migration events.
-The creatingApplication container is repeatable if more than one application processed the object in turn. For example, a file could be created by Microsoft Word and later turned into a PDF using Adobe Acrobat. Details of both the Word and Acrobat applications may be recorded. However, if both files are stored in the repository, each file should be completely described as an Object entity and linked by using relationship information with a relationshipType “derivation.”
-It may also be repeated to record the creating application before the object was ingested as well as the creating application used as part of the ingest process. For example, an HTML file was created pre-ingest using Dreamweaver, and the Web crawler Heritrix then captured a snapshot of the files as part of the ingest.
-The amount of information needed for creatingApplication given here is minimal. For more granularity, extensibility is provided.
-Rather than having each repository record this locally, it would be preferable to have a registry of this information similar to format or environment registries.).freeze],
+      comment: ["Creation / Maintenance Notes: If the object was created by the repository, assignment of creating application information should be straightforward.\nIf the object was created outside the repository, it is possible this information could be supplied by the depositor. It might also be extracted from the file itself; the name of the creating application is often embedded within the file.".freeze, "Definition: Information about the application that created the object.".freeze, "Rationale: Information about the creating application, including the version of the application and the date the file was created, can be useful for problem solving purposes. For example, it is not uncommon for certain versions of software to be known for causing conversion errors or introducing artifacts. It is also useful to determine which rendering software is available for the digital object. For example, if you know that the Distiller program created the PDF file, you know it will be renderable with (among other programs) Adobe Reader.".freeze, "Usage Notes: This semantic unit applies to both objects created external to the repository and subsequently ingested, and to objects created by the repository, for example, through migration events.\nThe creatingApplication container is repeatable if more than one application processed the object in turn. For example, a file could be created by Microsoft Word and later turned into a PDF using Adobe Acrobat. Details of both the Word and Acrobat applications may be recorded. However, if both files are stored in the repository, each file should be completely described as an Object entity and linked by using relationship information with a relationshipType “derivation.”\nIt may also be repeated to record the creating application before the object was ingested as well as the creating application used as part of the ingest process. For example, an HTML file was created pre-ingest using Dreamweaver, and the Web crawler Heritrix then captured a snapshot of the files as part of the ingest.\nThe amount of information needed for creatingApplication given here is minimal. For more granularity, extensibility is provided.\nRather than having each repository record this locally, it would be preferable to have a registry of this information similar to format or environment registries.".freeze],
       subClassOf: term(
           type: "owl:Class".freeze,
           unionOf: list(term(
@@ -1134,10 +1121,7 @@ Rather than having each repository record this locally, it would be preferable t
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Dependency,
-      comment: [%(Creation / Maintenance Notes: Recommended practice is for a repository to archive objects on which other objects depend. These may be sent by the submitter of the primary object, or they may in some cases be automatically obtained by the repository. For example, a markup file will often contain links to other objects it requires such as DTDs or XML Schema. If it does, these objects can often be identified by the link and downloaded by the repository.).freeze, %(Definition: Information about a non-software component or associated file needed in order to use or render the representation or file, for example, a schema, a DTD, or an entity file declaration.).freeze, %(Usage Notes: This semantic unit is for additional objects that are necessary to render a file or representation, not for required software or hardware. It may also be used for a non-executable component of the object, such as a font or style sheet. For things that the software requires, see swDependency.
-This semantic unit does not include objects required by structural relationships, such as child content objects \(e.g., figures that are part of an article\), which are recorded under relationship with a relationshipType of “structural”.
-It is up to the repository to determine what constitutes a dependency in the context of the designated community.
-The objects noted may be internal or external to the preservation repository.).freeze],
+      comment: ["Creation / Maintenance Notes: Recommended practice is for a repository to archive objects on which other objects depend. These may be sent by the submitter of the primary object, or they may in some cases be automatically obtained by the repository. For example, a markup file will often contain links to other objects it requires such as DTDs or XML Schema. If it does, these objects can often be identified by the link and downloaded by the repository.".freeze, "Definition: Information about a non-software component or associated file needed in order to use or render the representation or file, for example, a schema, a DTD, or an entity file declaration.".freeze, "Usage Notes: This semantic unit is for additional objects that are necessary to render a file or representation, not for required software or hardware. It may also be used for a non-executable component of the object, such as a font or style sheet. For things that the software requires, see swDependency.\nThis semantic unit does not include objects required by structural relationships, such as child content objects (e.g., figures that are part of an article), which are recorded under relationship with a relationshipType of “structural”.\nIt is up to the repository to determine what constitutes a dependency in the context of the designated community.\nThe objects noted may be internal or external to the preservation repository.".freeze],
       subClassOf: term(
           type: "owl:Class".freeze,
           unionOf: list(term(
@@ -1153,9 +1137,7 @@ The objects noted may be internal or external to the preservation repository.).f
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Environment,
-      comment: [%(Creation / Maintenance Notes: This information may be omitted when the repository is doing only bit-level preservation on the object.
-Rather than having each repository record this locally, it would be preferable to have a registry of environment information similar to proposed registries of format information.
-Repositories may choose to design mechanisms for inheritance, so that if the environment required for each file within a representation is identical to the environment recorded for the representation as a whole, it is not necessary to store this information in each file.).freeze, %(Definition: Hardware/software combinations supporting use of the object.).freeze, %(Rationale: Environment is the means by which the user renders and interacts with content. Separation of digital content from its environmental context can result in the content becoming unusable.).freeze, %(Usage Notes: All of this semantic units’ subunits are optional. At least one subunit \(i.e. environmentNote, dependency, software, hardware, and/or environmentExtension\) must be present if this container is included.).freeze],
+      comment: ["Creation / Maintenance Notes: This information may be omitted when the repository is doing only bit-level preservation on the object.\nRather than having each repository record this locally, it would be preferable to have a registry of environment information similar to proposed registries of format information.\nRepositories may choose to design mechanisms for inheritance, so that if the environment required for each file within a representation is identical to the environment recorded for the representation as a whole, it is not necessary to store this information in each file.".freeze, "Definition: Hardware/software combinations supporting use of the object.".freeze, "Rationale: Environment is the means by which the user renders and interacts with content. Separation of digital content from its environmental context can result in the content becoming unusable.".freeze, "Usage Notes: All of this semantic units’ subunits are optional. At least one subunit (i.e. environmentNote, dependency, software, hardware, and/or environmentExtension) must be present if this container is included.".freeze],
       subClassOf: term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasEnvironmentCharacteristic".freeze,
@@ -1164,13 +1146,7 @@ Repositories may choose to design mechanisms for inheritance, so that if the env
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Event,
-      comment: [%(Entity properties:
-Must be related to one or more objects.
-Can be related to one or more agents.
-Links between entities may be recorded from either direction and need not be bi-directional.).freeze, %(The Event entity aggregates information about an action that involves one or more Object entities. Metadata about an Event would normally be recorded and stored separately from the digital object.
-Whether or not a preservation repository records an Event depends upon the importance of the event. Actions that modify objects should always be recorded. Other actions such as copying an object for backup purposes may be recorded in system logs or an audit trail but not necessarily in
-an Event entity.
-Mandatory semantic units are: eventIdentifier, eventType, and eventDateTime.).freeze],
+      comment: ["Entity properties:\nMust be related to one or more objects.\nCan be related to one or more agents.\nLinks between entities may be recorded from either direction and need not be bi-directional.".freeze, "The Event entity aggregates information about an action that involves one or more Object entities. Metadata about an Event would normally be recorded and stored separately from the digital object.\nWhether or not a preservation repository records an Event depends upon the importance of the event. Actions that modify objects should always be recorded. Other actions such as copying an object for backup purposes may be recorded in system logs or an audit trail but not necessarily in\nan Event entity.\nMandatory semantic units are: eventIdentifier, eventType, and eventDateTime.".freeze],
       subClassOf: ["premis:PremisEntity".freeze, term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1190,9 +1166,7 @@ Mandatory semantic units are: eventIdentifier, eventType, and eventDateTime.).fr
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :EventOutcomeDetail,
-      comment: [%(Definition: A detailed description of the result or product of the event.).freeze, %(Rationale: An event outcome may be sufficiently complex that a coded description is not adequate to document it.).freeze, %(Usage Notes: This may be used to record all error and warning messages issued by a program involved in the event or to record a pointer to an error log.
-If the event was a validity check \(e.g., profile conformance\) any anomalies or quirks discovered would be recorded here.
-All subunits of this semantic unit are optional. At least one subunit \(i.e. eventOutcomeDetailNote and/or eventOutcomeDetailExtension\) must be present if this container is included.).freeze],
+      comment: ["Definition: A detailed description of the result or product of the event.".freeze, "Rationale: An event outcome may be sufficiently complex that a coded description is not adequate to document it.".freeze, "Usage Notes: This may be used to record all error and warning messages issued by a program involved in the event or to record a pointer to an error log.\nIf the event was a validity check (e.g., profile conformance) any anomalies or quirks discovered would be recorded here.\nAll subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcomeDetailNote and/or eventOutcomeDetailExtension) must be present if this container is included.".freeze],
       subClassOf: term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasEventOutcomeDetailNote".freeze,
@@ -1201,8 +1175,7 @@ All subunits of this semantic unit are optional. At least one subunit \(i.e. eve
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :EventOutcomeInformation,
-      comment: [%(Definition: Information about the outcome of an event.).freeze, %(Usage Notes: A repository may wish to supplement a coded eventOutcome value with additional information in eventOutcomeDetail. Since events may have more than one outcome, the container is repeatable.
-All subunits of this semantic unit are optional. At least one subunit \(i.e. eventOutcome or eventOutcomeDetail\) must be present if this container is included.).freeze],
+      comment: ["Definition: Information about the outcome of an event.".freeze, "Usage Notes: A repository may wish to supplement a coded eventOutcome value with additional information in eventOutcomeDetail. Since events may have more than one outcome, the container is repeatable.\nAll subunits of this semantic unit are optional. At least one subunit (i.e. eventOutcome or eventOutcomeDetail) must be present if this container is included.".freeze],
       subClassOf: term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasEventOutcome".freeze,
@@ -1211,7 +1184,7 @@ All subunits of this semantic unit are optional. At least one subunit \(i.e. eve
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :File,
-      comment: %(Definition: A named and ordered sequence of bytes that is known to an operating system.).freeze,
+      comment: "Definition: A named and ordered sequence of bytes that is known to an operating system.".freeze,
       "rdfs:seeAlso": "Object class definition".freeze,
       subClassOf: ["premis:Object".freeze, term(
           minCardinality: "1".freeze,
@@ -1221,10 +1194,7 @@ All subunits of this semantic unit are optional. At least one subunit \(i.e. eve
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Fixity,
-      comment: [%(Creation / Maintenance Notes: Automatically calculated and recorded by repository.).freeze, %(Definition: Information used to verify whether an object has been altered in an undocumented or unauthorized way.).freeze, %(Usage Notes: To perform a fixity check, a message digest calculated at some earlier time is compared with a message digest calculated at a later time. If the digests are the same, the object was not altered in the interim. Recommended practice is to use two or more message digests calculated by different algorithms. \(Note that the terms “message digest” and “checksum” are commonly used interchangeably. However, the term “checksum” is more correctly used for the product of a cyclical redundancy check \(CRC\), whereas the term “message digest” refers to the result of a cryptographic hash function, which is what is referred to here.\)
-The act of performing a fixity check and the date it occurred would be recorded as an Event. The result of the check would be recorded as the eventOutcome. Therefore, only the messageDigestAlgorithm and messageDigest need to be recorded as objectCharacteristics for future comparison.
-Representation level: It could be argued that if a representation consists of a single file or if all the files comprised by a representation are combined \(e.g., zipped\) into a single file, then a fixity check could be performed on the representation. However, in both cases the fixity check is actually being performed on a file, which in this case happens to be coincidental with a representation.
-Bitstream level: Message digests can be computed for bitstreams although they are not as common as with files. For example, the JPX format, which is a JPEG2000 format, supports the inclusion of MD5 or SHA-1 message digests in internal metadata that was calculated on any range of bytes of the file.).freeze],
+      comment: ["Creation / Maintenance Notes: Automatically calculated and recorded by repository.".freeze, "Definition: Information used to verify whether an object has been altered in an undocumented or unauthorized way.".freeze, "Usage Notes: To perform a fixity check, a message digest calculated at some earlier time is compared with a message digest calculated at a later time. If the digests are the same, the object was not altered in the interim. Recommended practice is to use two or more message digests calculated by different algorithms. (Note that the terms “message digest” and “checksum” are commonly used interchangeably. However, the term “checksum” is more correctly used for the product of a cyclical redundancy check (CRC), whereas the term “message digest” refers to the result of a cryptographic hash function, which is what is referred to here.)\nThe act of performing a fixity check and the date it occurred would be recorded as an Event. The result of the check would be recorded as the eventOutcome. Therefore, only the messageDigestAlgorithm and messageDigest need to be recorded as objectCharacteristics for future comparison.\nRepresentation level: It could be argued that if a representation consists of a single file or if all the files comprised by a representation are combined (e.g., zipped) into a single file, then a fixity check could be performed on the representation. However, in both cases the fixity check is actually being performed on a file, which in this case happens to be coincidental with a representation.\nBitstream level: Message digests can be computed for bitstreams although they are not as common as with files. For example, the JPX format, which is a JPEG2000 format, supports the inclusion of MD5 or SHA-1 message digests in internal metadata that was calculated on any range of bytes of the file.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1240,8 +1210,7 @@ Bitstream level: Message digests can be computed for bitstreams although they ar
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Format,
-      comment: [%(Creation / Maintenance Notes: The format of a file or bitstream should be ascertained by the repository on ingest. Even if this information is provided by the submitter, directly in metadata or indirectly via the file name extension, recommended practice is to independently identify the format by parsing the file when possible. If the format cannot be identified at the time of ingest, it is valid to record that it is unknown, but the repository should subsequently make an effort to identify the format, even if manual intervention is required.).freeze, %(Definition: Identification of the format of a file or bitstream where format is the organization of digital information according to preset specifications.).freeze, %(Rationale: Many preservation activities depend on detailed knowledge about the format of the digital object. An accurate identification of format is essential. The identification provided, whether by name or pointer into a format registry, should be sufficient to associate the object with more detailed format information.).freeze, %(Usage Notes: A bitstream embedded within a file may have different characteristics than the larger file. For example, a bitstream in LaTex format could be embedded within an SGML file, or multiple images using different colorspaces could be embedded within a TIFF file. format must be recorded for every object. When the bitstream format can be recognized by the repository and the repository might want to treat the bitstream differently from the embedding file for preservation purposes, format can be recorded for embedded bitstreams.
-Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit \(i.e. either formatDesignation or formatRegistry\) must be present if this container is included or both may be used. If the subunit \(formatDesignation or formatRegistry\) needs to be repeated, the entire format container is repeated. This allows for association of format designation with a particular set of format registry information. For example, if the precise format cannot be determined and two format designations are recorded, each is given within a separate format container. The format container may also be repeated for multiple format registry entries.).freeze],
+      comment: ["Creation / Maintenance Notes: The format of a file or bitstream should be ascertained by the repository on ingest. Even if this information is provided by the submitter, directly in metadata or indirectly via the file name extension, recommended practice is to independently identify the format by parsing the file when possible. If the format cannot be identified at the time of ingest, it is valid to record that it is unknown, but the repository should subsequently make an effort to identify the format, even if manual intervention is required.".freeze, "Definition: Identification of the format of a file or bitstream where format is the organization of digital information according to preset specifications.".freeze, "Rationale: Many preservation activities depend on detailed knowledge about the format of the digital object. An accurate identification of format is essential. The identification provided, whether by name or pointer into a format registry, should be sufficient to associate the object with more detailed format information.".freeze, "Usage Notes: A bitstream embedded within a file may have different characteristics than the larger file. For example, a bitstream in LaTex format could be embedded within an SGML file, or multiple images using different colorspaces could be embedded within a TIFF file. format must be recorded for every object. When the bitstream format can be recognized by the repository and the repository might want to treat the bitstream differently from the embedding file for preservation purposes, format can be recorded for embedded bitstreams.\nAlthough this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either formatDesignation or formatRegistry) must be present if this container is included or both may be used. If the subunit (formatDesignation or formatRegistry) needs to be repeated, the entire format container is repeated. This allows for association of format designation with a particular set of format registry information. For example, if the precise format cannot be determined and two format designations are recorded, each is given within a separate format container. The format container may also be repeated for multiple format registry entries.".freeze],
       subClassOf: term(
           type: "owl:Class".freeze,
           unionOf: list(term(
@@ -1257,8 +1226,7 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :FormatDesignation,
-      comment: [%(Definition: An identification of the format of the object.).freeze, %(Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. Both may be included.
-The most specific format \(or format profile\) should be recorded. A repository \(or formats registry\) may wish to use multipart format names \(e.g., “TIFF_GeoTIFF” or “WAVE_MPEG_BWF”\) to achieve this specificity.).freeze],
+      comment: ["Definition: An identification of the format of the object.".freeze, "Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. Both may be included.\nThe most specific format (or format profile) should be recorded. A repository (or formats registry) may wish to use multipart format names (e.g., “TIFF_GeoTIFF” or “WAVE_MPEG_BWF”) to achieve this specificity.".freeze],
       subClassOf: term(
           cardinality: "1".freeze,
           onProperty: "premis:hasFormatName".freeze,
@@ -1267,8 +1235,7 @@ The most specific format \(or format profile\) should be recorded. A repository
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :FormatRegistry,
-      comment: [%(Definition: Identifies and/or gives further information about the format by reference to an entry in a format registry.).freeze, %(Rationale: If central format registries are available to the preservation repository, they may provide an excellent way of referencing detailed format information.).freeze, %(Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. If more than one formatRegistry needs to be recorded the format container should be repeated to include each additional set of formatRegistry information.
-The PREMIS working group assumed that a number of format registries will be developed and maintained to support digital preservation efforts. The proposal for a Global Digital Format Registry \(GDFR\) \(http://hul.harvard.edu/gdfr/documents.html#data\), for example, would create a network-accessible registry designed to store detailed specifications on formats and profiles.).freeze],
+      comment: ["Definition: Identifies and/or gives further information about the format by reference to an entry in a format registry.".freeze, "Rationale: If central format registries are available to the preservation repository, they may provide an excellent way of referencing detailed format information.".freeze, "Usage Notes: Either formatDesignation or at least one instance of formatRegistry is required. If more than one formatRegistry needs to be recorded the format container should be repeated to include each additional set of formatRegistry information.\nThe PREMIS working group assumed that a number of format registries will be developed and maintained to support digital preservation efforts. The proposal for a Global Digital Format Registry (GDFR) (http://hul.harvard.edu/gdfr/documents.html#data), for example, would create a network-accessible registry designed to store detailed specifications on formats and profiles.".freeze],
       subClassOf: [term(
           cardinality: "1".freeze,
           onProperty: "premis:hasFormatRegistryKey".freeze,
@@ -1281,8 +1248,7 @@ The PREMIS working group assumed that a number of format registries will be deve
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Hardware,
-      comment: [%(Creation / Maintenance Notes: Hardware environment information can be very difficult to provide. Many different hardware environments may apply; there are a huge number of combinations of maker and type of CPU, memory, video drivers, and so on. Although at least one hardware environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which hardware environments to record.
-Because of the difficulty recording this information comprehensively, it would be optimal if central registries of environment information existed. In many cases the environment of a file object is directly associated with the format, making registry lookup by format feasible. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to hwEnvironment.).freeze, %(Definition: Hardware components needed by the software referenced in swName or the human user of the referenced software.).freeze],
+      comment: ["Creation / Maintenance Notes: Hardware environment information can be very difficult to provide. Many different hardware environments may apply; there are a huge number of combinations of maker and type of CPU, memory, video drivers, and so on. Although at least one hardware environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which hardware environments to record.\nBecause of the difficulty recording this information comprehensively, it would be optimal if central registries of environment information existed. In many cases the environment of a file object is directly associated with the format, making registry lookup by format feasible. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to hwEnvironment.".freeze, "Definition: Hardware components needed by the software referenced in swName or the human user of the referenced software.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1298,7 +1264,7 @@ Because of the difficulty recording this information comprehensively, it would b
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Identifier,
-      comment: %(This class is used in PREMIS OWL to describe identifiers if the identifiers are not http URIs.).freeze,
+      comment: "This class is used in PREMIS OWL to describe identifiers if the identifiers are not http URIs.".freeze,
       subClassOf: [term(
           cardinality: "1".freeze,
           onProperty: "premis:hasIdentifierType".freeze,
@@ -1311,9 +1277,7 @@ Because of the difficulty recording this information comprehensively, it would b
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Inhibitors,
-      comment: [%(Creation / Maintenance Notes: Inhibitors are more likely to be present on an object ingested by the repository than applied by the repository itself. It is often not possible to tell that a file has been encrypted by parsing it; the file may appear to be ASCII text. Therefore, information about inhibitors should be supplied as metadata with submitted objects when possible.).freeze, %(Definition: Features of the object intended to inhibit access, use, or migration.).freeze, %(Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.).freeze, %(Usage Notes: Some file formats allow encryption for embedded bitstreams.
-Some file formats such as PDF use passwords to control access to content or specific functions. Although this is actually implemented at the bitstream level, for preservation purposes it is effectively managed at the file level; that is, passwords would not be recorded for individually addressable bitstreams.
-For certain types of inhibitor keys, more granularity may be required. If the inhibitor key information is identical to key information in digital signatures, use those semantic units.).freeze],
+      comment: ["Creation / Maintenance Notes: Inhibitors are more likely to be present on an object ingested by the repository than applied by the repository itself. It is often not possible to tell that a file has been encrypted by parsing it; the file may appear to be ASCII text. Therefore, information about inhibitors should be supplied as metadata with submitted objects when possible.".freeze, "Definition: Features of the object intended to inhibit access, use, or migration.".freeze, "Rationale: Format information may indicate whether a file is encrypted, but the nature of the encryption also must be recorded, as well as the access key.".freeze, "Usage Notes: Some file formats allow encryption for embedded bitstreams.\nSome file formats such as PDF use passwords to control access to content or specific functions. Although this is actually implemented at the bitstream level, for preservation purposes it is effectively managed at the file level; that is, passwords would not be recorded for individually addressable bitstreams.\nFor certain types of inhibitor keys, more granularity may be required. If the inhibitor key information is identical to key information in digital signatures, use those semantic units.".freeze],
       subClassOf: term(
           cardinality: "1".freeze,
           onProperty: "premis:hasInhibitorType".freeze,
@@ -1322,12 +1286,12 @@ For certain types of inhibitor keys, more granularity may be required. If the in
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :IntellectualEntity,
-      comment: [%(Definition: a set of content that is considered a single intellectual unit for purposes of management and description: for example, a particular book, map, photograph, or database. An Intellectual Entity can include other Intellectual Entities; for example, a Web site can include a Web page; a Web page can include an image. An Intellectual Entity may have one or more digital representations.).freeze, %(Intellectual entities are described via Descriptive metadata models. These are very domain-specific and are out of scope for PREMIS. Examples: Dublin Core, Mets, MARC).freeze],
+      comment: ["Definition: a set of content that is considered a single intellectual unit for purposes of management and description: for example, a particular book, map, photograph, or database. An Intellectual Entity can include other Intellectual Entities; for example, a Web site can include a Web page; a Web page can include an image. An Intellectual Entity may have one or more digital representations.".freeze, "Intellectual entities are described via Descriptive metadata models. These are very domain-specific and are out of scope for PREMIS. Examples: Dublin Core, Mets, MARC".freeze],
       subClassOf: "premis:PremisEntity".freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :LicenseInformation,
-      comment: [%(Definition: Information about a license or other agreement granting permissions related to an object.).freeze, %(Usage Note: When rights basis is a license, licenseInformation should be provided.).freeze],
+      comment: ["Definition: Information about a license or other agreement granting permissions related to an object.".freeze, "Usage Note: When rights basis is a license, licenseInformation should be provided.".freeze],
       subClassOf: ["premis:RightsStatement".freeze, term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasLicenseTerms".freeze,
@@ -1336,22 +1300,12 @@ For certain types of inhibitor keys, more granularity may be required. If the in
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Object,
-      comment: [%(Entity properties:
-Can be associated with one or more rights statements.
-Can participate in one or more events.
-Links between entities may be recorded from either direction and need not be bi-directional.).freeze, %(Entity types: 
-Representation: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity.
-File: A named and ordered sequence of bytes that is known to an operating system.
-Bitstream: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.).freeze, %(The object class aggregates information about a digital object held by a preservation repository and describes those characteristics relevant to preservation management. The only mandatory property is objectIdentifier.
-The object class has three subclasses: Representation, File, and Bitstream.).freeze],
+      comment: ["Entity properties:\nCan be associated with one or more rights statements.\nCan participate in one or more events.\nLinks between entities may be recorded from either direction and need not be bi-directional.".freeze, "Entity types: \nRepresentation: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity.\nFile: A named and ordered sequence of bytes that is known to an operating system.\nBitstream: Contiguous or non-contiguous data within a file that has meaningful properties for preservation purposes.".freeze, "The object class aggregates information about a digital object held by a preservation repository and describes those characteristics relevant to preservation management. The only mandatory property is objectIdentifier.\nThe object class has three subclasses: Representation, File, and Bitstream.".freeze],
       subClassOf: "premis:PremisEntity".freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :ObjectCharacteristics,
-      comment: [%(Definition: Technical properties of a file or bitstream that are applicable to all or most formats.).freeze, %(Rationale: There are some important technical properties that apply to objects of any format. Detailed definition of format-specific properties is outside the scope of this Data Dictionary, although such properties may be included within objectCharacteristicsExtension.).freeze, %(Usage Notes: The semantic units included in objectCharacteristics should be treated as a set of information that pertains to a single object at a single compositionLevel. Object characteristics may be repeated when an object was created by applying two or more encodings, such as compression and encryption. In this case each repetition of objectCharacteristics would have an incrementally higher compositionLevel.
-When encryption is applied, the objectCharacteristics block must include an inhibitors semantic unit.
-A bitstream embedded within a file may have different object characteristics than the file. Where these characteristics are relevant for preservation, they should be recorded.
-When a single file is equivalent to a representation, objectCharacteristics may be applied and thus associated with the representation. In these cases, the relationship between the file comprising the representation and other associated files may be expressed using relationshipSubType.).freeze],
+      comment: ["Definition: Technical properties of a file or bitstream that are applicable to all or most formats.".freeze, "Rationale: There are some important technical properties that apply to objects of any format. Detailed definition of format-specific properties is outside the scope of this Data Dictionary, although such properties may be included within objectCharacteristicsExtension.".freeze, "Usage Notes: The semantic units included in objectCharacteristics should be treated as a set of information that pertains to a single object at a single compositionLevel. Object characteristics may be repeated when an object was created by applying two or more encodings, such as compression and encryption. In this case each repetition of objectCharacteristics would have an incrementally higher compositionLevel.\nWhen encryption is applied, the objectCharacteristics block must include an inhibitors semantic unit.\nA bitstream embedded within a file may have different object characteristics than the file. Where these characteristics are relevant for preservation, they should be recorded.\nWhen a single file is equivalent to a representation, objectCharacteristics may be applied and thus associated with the representation. In these cases, the relationship between the file comprising the representation and other associated files may be expressed using relationshipSubType.".freeze],
       subClassOf: [term(
           cardinality: "1".freeze,
           onProperty: "premis:hasCompositionLevel".freeze,
@@ -1364,15 +1318,13 @@ When a single file is equivalent to a representation, objectCharacteristics may
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :PremisEntity,
-      comment: %(Definition: Basicly, the preservation information in PREMIS OWL consists of five entities related to each other. The entities are: Agent, Event, IntellectualEntity, Object, and RightsStatement.).freeze,
+      comment: "Definition: Basicly, the preservation information in PREMIS OWL consists of five entities related to each other. The entities are: Agent, Event, IntellectualEntity, Object, and RightsStatement.".freeze,
       "owl:versionInfo": "PREMIS 2.2 Owl v2".freeze,
       subClassOf: "owl:Thing".freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :PreservationLevel,
-      comment: [%(Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata. The repository may also choose to record additional metadata indicating the context for the assignment of the preservation level.).freeze, %(Definition: Information indicating the decision or policy on the set of preservation functions to be applied to an object and the context in which the decision or policy was made.).freeze, %(Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc. The context surrounding the choice of a particular preservation option for an object may also require further explanation.).freeze, %(Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository.
-Application of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied.
-The container may be repeated if a preservation level value needs to be recorded in additional contexts \(see preservationLevelRole\).).freeze],
+      comment: ["Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata. The repository may also choose to record additional metadata indicating the context for the assignment of the preservation level.".freeze, "Definition: Information indicating the decision or policy on the set of preservation functions to be applied to an object and the context in which the decision or policy was made.".freeze, "Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc. The context surrounding the choice of a particular preservation option for an object may also require further explanation.".freeze, "Usage Notes: If the repository offers only a single preservation level, this value does not need to be explicitly recorded within the repository.\nApplication of a particular set of preservationLevel semantic units may only cover a single representation of an object: representations in other technical forms or serving other functions may have a different preservationLevel applied.\nThe container may be repeated if a preservation level value needs to be recorded in additional contexts (see preservationLevelRole).".freeze],
       subClassOf: [term(
           cardinality: "1".freeze,
           onProperty: "premis:hasPreservationLevelValue".freeze,
@@ -1385,7 +1337,7 @@ The container may be repeated if a preservation level value needs to be recorded
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :RelatedObjectIdentification,
-      comment: [%( Definition: The identifier and sequential context of the related resource).freeze, %(Usage Notes: The related object may or may not be held within the preservation repository. Recommended practice is that objects reside within the repository unless there is a good reason to reference an object outside. Internal and external references should be clear.).freeze],
+      comment: [" Definition: The identifier and sequential context of the related resource".freeze, "Usage Notes: The related object may or may not be held within the preservation repository. Recommended practice is that objects reside within the repository unless there is a good reason to reference an object outside. Internal and external references should be clear.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1401,14 +1353,13 @@ The container may be repeated if a preservation level value needs to be recorded
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Representation,
-      comment: %(Definition: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity.).freeze,
+      comment: "Definition: A digital object instantiating or embodying an Intellectual Entity. A representation is the set of stored digital files and structural metadata needed to provide a complete and reasonable rendition of the Intellectual Entity.".freeze,
       "rdfs:seeAlso": "Object class definition".freeze,
       subClassOf: "premis:Object".freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :RightsDocumentation,
-      comment: %(Definition: A designation used to uniquely identify documentation supporting the
-specified rights within the repository system.).freeze,
+      comment: "Definition: A designation used to uniquely identify documentation supporting the\nspecified rights within the repository system.".freeze,
       subClassOf: term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasRightsDocumentationRole".freeze,
@@ -1417,7 +1368,7 @@ specified rights within the repository system.).freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :RightsGranted,
-      comment: %(Definition: The action\(s\) that the granting agency has allowed the repository.).freeze,
+      comment: "Definition: The action(s) that the granting agency has allowed the repository.".freeze,
       subClassOf: [term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1437,9 +1388,7 @@ specified rights within the repository system.).freeze,
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :RightsStatement,
-      comment: [%(Definition: Documentation of the repository's right to perform one or more acts.).freeze, %(Extensions:  In OWL one can define its own subclasses to the the RightsStatement class to denote OtherRightsInformation of the PREMIS data dictionary.).freeze, %(Usage Notes: This semantic unit is optional because in some cases rights may be unknown. Institutions are encouraged to record rights information when possible.
-Either rightsStatement or rightsExtension must be present if the Rights entity is included.
-The rightsStatement should be repeated when the act\(s\) described has more than one basis, or when different acts have different bases.).freeze],
+      comment: ["Definition: Documentation of the repository's right to perform one or more acts.".freeze, "Extensions:  In OWL one can define its own subclasses to the the RightsStatement class to denote OtherRightsInformation of the PREMIS data dictionary.".freeze, "Usage Notes: This semantic unit is optional because in some cases rights may be unknown. Institutions are encouraged to record rights information when possible.\nEither rightsStatement or rightsExtension must be present if the Rights entity is included.\nThe rightsStatement should be repeated when the act(s) described has more than one basis, or when different acts have different bases.".freeze],
       subClassOf: ["dc:RightsStatement".freeze, "premis:PremisEntity".freeze, term(
           maxCardinality: "1".freeze,
           onProperty: "premis:hasApplicableDates".freeze,
@@ -1452,7 +1401,7 @@ The rightsStatement should be repeated when the act\(s\) described has more than
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Signature,
-      comment: [%(Definition: Information needed to use a digital signature to authenticate the signer of an object and/or the information contained in the object.).freeze, %(Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.).freeze, %(Usage Notes: Several of the semantic components of signatureInformation are taken from the W3C’s XML-Signature Syntax and Processing; see www.w3.org/TR/2002/REC-xmldsig-core-20020212/ for more information on the structure and application of these semantic units.).freeze],
+      comment: ["Definition: Information needed to use a digital signature to authenticate the signer of an object and/or the information contained in the object.".freeze, "Rationale: A repository may have a policy of generating digital signatures for files on ingest, or may have a need to store and later validate incoming digital signatures.".freeze, "Usage Notes: Several of the semantic components of signatureInformation are taken from the W3C’s XML-Signature Syntax and Processing; see www.w3.org/TR/2002/REC-xmldsig-core-20020212/ for more information on the structure and application of these semantic units.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1476,31 +1425,11 @@ The rightsStatement should be repeated when the act\(s\) described has more than
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :SignificantProperties,
-      comment: [%(Creation / Maintenance Notes: Significant properties may pertain to all objects of a certain class; for example, the repository can decide that for all PDF files, only the content need be preserved. In other cases, for example, for media art, the significant properties may be unique to each individual object. Where values are unique, they must be supplied by the submitter or provided by the curatorial staff of the repository.).freeze, %(Definition: Characteristics of a particular object subjectively determined to be important to maintain through preservation actions.).freeze, %(Rationale: Objects that have the same technical properties may still differ as to the properties that should be preserved for future presentation or use.).freeze, %(Usage Notes: All of this semantic unit’s subunits are optional. At least one of the significantPropertiesValue and significantPropertiesExtension subunits must be present if this container is included or both may be used.
-Significant properties may be objective technical characteristics subjectively considered important, or subjectively determined characteristics. For example, a PDF may contain links that are not considered important and JavaScript that is considered important. Or future migrations of a TIFF image may require optimization for line clarity or for color; the option chosen would depend upon a curatorial judgment of the significant properties of the image.
-Listing significant properties implies that the repository plans to preserve these properties across time and requires them to acceptably survive preservation action; for example, to be maintained during emulation or after format migration. It also implies that the repository would note when preservation action results in modification of significant properties.
-In practice, significant properties might be used as measures of preservation success, as part of quality checking the results of a preservation action or evaluating the efficacy of a preservation method. For example, if the listed significant properties are not maintained after application of a particular preservation method, it may indicate a failure of the process or that the method is not well suited to the type of material.
-More experience with digital preservation is needed to determine the best ways of representing significant properties in general, and of representing modification of significant properties.
-The semantic units included in the significantProperties container aim to provide a flexible structure for describing significant properties, allowing general types of aspects, facets or attributes of an object to be declared and to be paired with specific significant details about the object pertaining to that aspect, facet or attribute.
-For example, some repositories may define significant properties for objects related to facets of content, appearance, structure, behavior, and context. Examples of facet:detail pairs in this case could include:
-significantPropertiesType = “content”
-significantPropertiesValue = “all textual content and images”
-significantPropertiesType = “behavior”
-significantPropertiesValue = “editable”
-Other repositories may choose to describe significant properties at a more granular attribute level; for example:
-significantPropertiesType = “page count”
-significantPropertiesValue = “7”
-significantPropertiesType = “page width”
-significantPropertiesValue = “210 mm”
-Each facet:detail pair should be contained in a separate, repeated significantProperties container.
-Further work on determining and describing significant properties may yield more detailed schemes to facilitate general description.
-Representing modification of significant properties as a result of preservation action also requires further work. One possible way involves the use of Object and Event information: Object A has significant properties volume and timing, which are recorded as significantProperties of A. In migrated version B, the timing is modified, which is noted in the eventOutcome of the migration event. Only volume is listed as a significant property of B.).freeze],
+      comment: ["Creation / Maintenance Notes: Significant properties may pertain to all objects of a certain class; for example, the repository can decide that for all PDF files, only the content need be preserved. In other cases, for example, for media art, the significant properties may be unique to each individual object. Where values are unique, they must be supplied by the submitter or provided by the curatorial staff of the repository.".freeze, "Definition: Characteristics of a particular object subjectively determined to be important to maintain through preservation actions.".freeze, "Rationale: Objects that have the same technical properties may still differ as to the properties that should be preserved for future presentation or use.".freeze, "Usage Notes: All of this semantic unit’s subunits are optional. At least one of the significantPropertiesValue and significantPropertiesExtension subunits must be present if this container is included or both may be used.\nSignificant properties may be objective technical characteristics subjectively considered important, or subjectively determined characteristics. For example, a PDF may contain links that are not considered important and JavaScript that is considered important. Or future migrations of a TIFF image may require optimization for line clarity or for color; the option chosen would depend upon a curatorial judgment of the significant properties of the image.\nListing significant properties implies that the repository plans to preserve these properties across time and requires them to acceptably survive preservation action; for example, to be maintained during emulation or after format migration. It also implies that the repository would note when preservation action results in modification of significant properties.\nIn practice, significant properties might be used as measures of preservation success, as part of quality checking the results of a preservation action or evaluating the efficacy of a preservation method. For example, if the listed significant properties are not maintained after application of a particular preservation method, it may indicate a failure of the process or that the method is not well suited to the type of material.\nMore experience with digital preservation is needed to determine the best ways of representing significant properties in general, and of representing modification of significant properties.\nThe semantic units included in the significantProperties container aim to provide a flexible structure for describing significant properties, allowing general types of aspects, facets or attributes of an object to be declared and to be paired with specific significant details about the object pertaining to that aspect, facet or attribute.\nFor example, some repositories may define significant properties for objects related to facets of content, appearance, structure, behavior, and context. Examples of facet:detail pairs in this case could include:\nsignificantPropertiesType = “content”\nsignificantPropertiesValue = “all textual content and images”\nsignificantPropertiesType = “behavior”\nsignificantPropertiesValue = “editable”\nOther repositories may choose to describe significant properties at a more granular attribute level; for example:\nsignificantPropertiesType = “page count”\nsignificantPropertiesValue = “7”\nsignificantPropertiesType = “page width”\nsignificantPropertiesValue = “210 mm”\nEach facet:detail pair should be contained in a separate, repeated significantProperties container.\nFurther work on determining and describing significant properties may yield more detailed schemes to facilitate general description.\nRepresenting modification of significant properties as a result of preservation action also requires further work. One possible way involves the use of Object and Event information: Object A has significant properties volume and timing, which are recorded as significantProperties of A. In migrated version B, the timing is modified, which is noted in the eventOutcome of the migration event. Only volume is listed as a significant property of B.".freeze],
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Software,
-      comment: [%(Creation / Maintenance Notes: If recording this explicitly, many different software environments may apply; for example, a particular object such as a PDF file may be viewable by several versions of several applications running under several operating systems and operating system versions. Although at least one software environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which software environments to record.
-Also, what appears to the user as a single rendering program can have many dependencies, including system utilities, runtime libraries, and so on, which each might have their own dependencies in turn.
-As with environment, metadata may be more efficiently managed in conjunction with a format registry either internal or external to a repository. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to software environment.).freeze, %(Definition: Software required to render or use the object.).freeze],
+      comment: ["Creation / Maintenance Notes: If recording this explicitly, many different software environments may apply; for example, a particular object such as a PDF file may be viewable by several versions of several applications running under several operating systems and operating system versions. Although at least one software environment should be recorded, it is not necessary to record them all and each repository will have to make its own decisions about which software environments to record.\nAlso, what appears to the user as a single rendering program can have many dependencies, including system utilities, runtime libraries, and so on, which each might have their own dependencies in turn.\nAs with environment, metadata may be more efficiently managed in conjunction with a format registry either internal or external to a repository. In the absence of a global mechanism, repositories may be forced to develop their own local “registries” relating format to software environment.".freeze, "Definition: Software required to render or use the object.".freeze],
       subClassOf: term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1516,7 +1445,7 @@ As with environment, metadata may be more efficiently managed in conjunction wit
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :StatuteInformation,
-      comment: [%(Definition: Information about the statute allowing use of the object.).freeze, %(Usage Notes: When rights basis is a statute, statuteInformation should be provided.).freeze],
+      comment: ["Definition: Information about the statute allowing use of the object.".freeze, "Usage Notes: When rights basis is a statute, statuteInformation should be provided.".freeze],
       subClassOf: ["premis:RightsStatement".freeze, term(
           intersectionOf: list(term(
             cardinality: "1".freeze,
@@ -1532,8 +1461,7 @@ As with environment, metadata may be more efficiently managed in conjunction wit
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :Storage,
-      comment: [%(Definition: Information about how and where a file is stored in the storage system.).freeze, %(Rationale: It is necessary for a repository to associate the contentLocation with the storageMedium.).freeze, %(Usage Notes: Normally there would be a single storage location and medium for an object, because an object in another location would be considered a different object. The storage composite should be repeated if there are two or more copies that are identical bit-wise and managed as a unit except for the medium on which they are stored. They must have a single objectIdentifier and be managed as a single object by the repository.
-Although this semantic unit is mandatory, both of its subunits are optional. At least one subunit \(i.e. either contentLocation or storageMedium\) must be present or both may be used.).freeze],
+      comment: ["Definition: Information about how and where a file is stored in the storage system.".freeze, "Rationale: It is necessary for a repository to associate the contentLocation with the storageMedium.".freeze, "Usage Notes: Normally there would be a single storage location and medium for an object, because an object in another location would be considered a different object. The storage composite should be repeated if there are two or more copies that are identical bit-wise and managed as a unit except for the medium on which they are stored. They must have a single objectIdentifier and be managed as a single object by the repository.\nAlthough this semantic unit is mandatory, both of its subunits are optional. At least one subunit (i.e. either contentLocation or storageMedium) must be present or both may be used.".freeze],
       subClassOf: term(
           type: "owl:Class".freeze,
           unionOf: list(term(
@@ -1549,7 +1477,7 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :TermOfGrant,
-      comment: [%(Definition: The time period for the permissions granted.).freeze, %(Rationale: The permission to preserve may be time bounded.).freeze],
+      comment: ["Definition: The time period for the permissions granted.".freeze, "Rationale: The permission to preserve may be time bounded.".freeze],
       subClassOf: ["premis:ApplicableDates".freeze, term(
           cardinality: "1".freeze,
           onProperty: "premis:hasStartDate".freeze,
@@ -1558,7 +1486,7 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
       type: "owl:Class".freeze,
       "vs:term_status": "stable".freeze
     term :TermOfRestriction,
-      comment: [%(Definition:  The time period for the restriction granted.).freeze, %(Rationale: The current definition of termOfGrant is "time period for the permissions granted." This allows for expressing information about the rights granted, but some repositories may need to express timebounded restrictions like embargoes. If this is applicable startDate for the beginning of the embargo and endDate for the end of the embargo should be recorded.).freeze],
+      comment: ["Definition:  The time period for the restriction granted.".freeze, "Rationale: The current definition of termOfGrant is \"time period for the permissions granted.\" This allows for expressing information about the rights granted, but some repositories may need to express timebounded restrictions like embargoes. If this is applicable startDate for the beginning of the embargo and endDate for the end of the embargo should be recorded.".freeze],
       subClassOf: ["premis:ApplicableDates".freeze, term(
           cardinality: "1".freeze,
           onProperty: "premis:hasStartDate".freeze,
@@ -1569,7 +1497,7 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
 
     # Property definitions
     property :hasAct,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/actionsGranted ).freeze, %(Definition: The action the preservation repository is allowed to take.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/actionsGranted ".freeze, "Definition: The action the preservation repository is allowed to take.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:RightsGranted".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1579,7 +1507,7 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasAgent,
-      comment: [%(Definition: link to the associated Agent.).freeze, %(Rationale: Digital provenance requires often that relationships between agents and events are documented. The role of the associated agent may need to be documented. For this, a SKOS vocabulary can be used. The LOC will publish a vocabulary at http://id.loc.gov/, denoting the agent's role. These vocabulary will publish the concepts also as subproperties to the linkingAgent property, for denoting the role of the agent in the event or rightsstatement.).freeze],
+      comment: ["Definition: link to the associated Agent.".freeze, "Rationale: Digital provenance requires often that relationships between agents and events are documented. The role of the associated agent may need to be documented. For this, a SKOS vocabulary can be used. The LOC will publish a vocabulary at http://id.loc.gov/, denoting the agent's role. These vocabulary will publish the concepts also as subproperties to the linkingAgent property, for denoting the role of the agent in the event or rightsstatement.".freeze],
       domain: term(
           type: "owl:Class".freeze,
           unionOf: list("premis:Event".freeze, "premis:RightsStatement".freeze)
@@ -1589,21 +1517,19 @@ Although this semantic unit is mandatory, both of its subunits are optional. At
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "testing".freeze
     property :hasAgentName,
-      comment: [%(Definition: A text string which could be used in addition to agentIdentifier to identify an agent.).freeze, %(Examples: Erik Owens, Pc).freeze, %(Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.).freeze, %(Usage Note: The value is not necessarily unique.).freeze],
+      comment: ["Definition: A text string which could be used in addition to agentIdentifier to identify an agent.".freeze, "Examples: Erik Owens, Pc".freeze, "Rationale: This semantic unit provides a more reader-friendly version of the agent identified by the agentIdentifier.".freeze, "Usage Note: The value is not necessarily unique.".freeze],
       domain: "premis:Agent".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasAgentNote,
-      comment: [%(Definition: Additional information about the agent.
-).freeze, %(Rationale: Additional information may be needed to describe or disambiguate
-the agent.).freeze],
+      comment: ["Definition: Additional information about the agent.\n".freeze, "Rationale: Additional information may be needed to describe or disambiguate\nthe agent.".freeze],
       domain: "premis:Agent".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasAgentType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/agentType ).freeze, %(Definition: A high-level characterization of the type of agent.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/agentType ".freeze, "Definition: A high-level characterization of the type of agent.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:Agent".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1619,10 +1545,7 @@ the agent.).freeze],
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasCompositionLevel,
-      comment: [%(Creation / Maintenance Notes: Composition level will generally be supplied by the repository, which should attempt to supply this value automatically. If the object was created by the repository, the creating routine knows the composition level and can supply this metadata. If the object is being ingested by the repository, repository programs will have to attempt to identify the composition level from the object itself or from externally supplied metadata.).freeze, %(Data Constraints: Non-negative integers.).freeze, %(Definition: An indication of whether the object is subject to one or more processes of decoding or unbundling.).freeze, %(Examples: 0, 1, 2).freeze, %(Rationale: A file or bitstream can be encoded with compression, encryption, etc., or bundled with other files or bitstreams into larger packages. Knowing the order in which these actions are taken is important if the original object or objects must be recovered.).freeze, %(Usage Notes: A file or bitstream can be subject to multiple encodings that must be decoded in reverse order \(highest to lowest\). For example, file A may be compressed to create file B, which is encrypted to create file C. To recreate a copy of the base file A, one would have to unencrypt file C to create file B and then uncompress file B to create file A. A compositionLevel of zero indicates that the object is a base object and not subject to further decoding, while a level of 1 or higher indicates that one or more decodings must be applied.
-Numbering goes lowest to highest \(first encoded = 0\). 0 is base object; 1-n are subsequent encodings.
-Use 0 as the default if there is only one compositionLevel.
-When multiple file objects are bundled together as filestreams within a package file object \(e.g., a ZIP file\), the individual filestream objects are not composition levels of the package file object. They should be considered separate objects, each with their own composition levels. For example, two encrypted files zipped together and stored in an archive as one file object would be described as three separate objects, each with its own associated metadata. The storage location of the two inner objects would point to the ZIP file, but the ZIP file itself would have only a single composition level \(of zero\) whose format would be “zip.”).freeze],
+      comment: ["Creation / Maintenance Notes: Composition level will generally be supplied by the repository, which should attempt to supply this value automatically. If the object was created by the repository, the creating routine knows the composition level and can supply this metadata. If the object is being ingested by the repository, repository programs will have to attempt to identify the composition level from the object itself or from externally supplied metadata.".freeze, "Data Constraints: Non-negative integers.".freeze, "Definition: An indication of whether the object is subject to one or more processes of decoding or unbundling.".freeze, "Examples: 0, 1, 2".freeze, "Rationale: A file or bitstream can be encoded with compression, encryption, etc., or bundled with other files or bitstreams into larger packages. Knowing the order in which these actions are taken is important if the original object or objects must be recovered.".freeze, "Usage Notes: A file or bitstream can be subject to multiple encodings that must be decoded in reverse order (highest to lowest). For example, file A may be compressed to create file B, which is encrypted to create file C. To recreate a copy of the base file A, one would have to unencrypt file C to create file B and then uncompress file B to create file A. A compositionLevel of zero indicates that the object is a base object and not subject to further decoding, while a level of 1 or higher indicates that one or more decodings must be applied.\nNumbering goes lowest to highest (first encoded = 0). 0 is base object; 1-n are subsequent encodings.\nUse 0 as the default if there is only one compositionLevel.\nWhen multiple file objects are bundled together as filestreams within a package file object (e.g., a ZIP file), the individual filestream objects are not composition levels of the package file object. They should be considered separate objects, each with their own composition levels. For example, two encrypted files zipped together and stored in an archive as one file object would be described as three separate objects, each with its own associated metadata. The storage location of the two inner objects would point to the ZIP file, but the ZIP file itself would have only a single composition level (of zero) whose format would be “zip.”".freeze],
       domain: "premis:ObjectCharacteristics".freeze,
       range: "xsd:int".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1634,7 +1557,7 @@ When multiple file objects are bundled together as filestreams within a package
       type: ["owl:FunctionalProperty".freeze, "owl:InverseFunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasContentLocationType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType).freeze, %(Definition: The means of referencing the location of the content.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: To understand the meaning of the value it is necessary to know what location scheme is used.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/contentLocationType".freeze, "Definition: The means of referencing the location of the content.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: To understand the meaning of the value it is necessary to know what location scheme is used.".freeze],
       domain: "premis:ContentLocation".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1644,19 +1567,19 @@ When multiple file objects are bundled together as filestreams within a package
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasContentLocationValue,
-      comment: [%(Definition: The reference to the location of the content used by the storage system.).freeze, %(Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ \(file\), c:\apache2\htdocs\index.html \(file\), 64 [offset from start of file c:\apache2\htdocs\image\logo.gif] \(bitstream\)).freeze, %(Usage Notes: This could be a fully qualified path and filename, or the information used by a resolution system \(e.g., a handle\) or the native information used by a storage management system. For a bitstream or filestream, this would probably be the reference point and offset of the starting position of the bitstream. It is up to the repository to determine the level of granularity that should be recorded.).freeze],
+      comment: ["Definition: The reference to the location of the content used by the storage system.".freeze, "Examples: http://wwasearch.loc.gov/107th/200212107035/http://house.gov/langevin/ (file), c:\\apache2\\htdocs\\index.html (file), 64 [offset from start of file c:\\apache2\\htdocs\\image\\logo.gif] (bitstream)".freeze, "Usage Notes: This could be a fully qualified path and filename, or the information used by a resolution system (e.g., a handle) or the native information used by a storage management system. For a bitstream or filestream, this would probably be the reference point and offset of the starting position of the bitstream. It is up to the repository to determine the level of granularity that should be recorded.".freeze],
       domain: "premis:ContentLocation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasCopyrightJurisdiction,
-      comment: [%(Data Constraint: Values should be taken from ISO 3166.).freeze, %(Definition: The country whose copyright laws apply.).freeze, %(Examples: us, de, be).freeze, %(Rationale: Copyright law can vary from country to country.).freeze],
+      comment: ["Data Constraint: Values should be taken from ISO 3166.".freeze, "Definition: The country whose copyright laws apply.".freeze, "Examples: us, de, be".freeze, "Rationale: Copyright law can vary from country to country.".freeze],
       domain: "premis:CopyrightInformation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasCopyrightStatus,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/copyrightStatus).freeze, %(Definition: A coded designation for the copyright status of the object at the time the rights statement is recorded.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/copyrightStatus".freeze, "Definition: A coded designation for the copyright status of the object at the time the rights statement is recorded.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:CopyrightInformation".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1666,7 +1589,7 @@ When multiple file objects are bundled together as filestreams within a package
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasCopyrightStatusDeterminationDate,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The date that the copyright status recorded in copyrightStatus was determined.).freeze, %(Example: 2001-10-26T19:32:52+00:00).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The date that the copyright status recorded in copyrightStatus was determined.".freeze, "Example: 2001-10-26T19:32:52+00:00".freeze],
       domain: "premis:CopyrightInformation".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1678,22 +1601,19 @@ When multiple file objects are bundled together as filestreams within a package
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasCreatingApplicationName,
-      comment: [%(Definition: A designation for the name of the software program that created the object.).freeze, %(Example: MSWord).freeze, %(Usage Notes: The creatingApplication is the application that created the object in its current format, not the application that created the copy written to storage. For example, if a document is created by Microsoft Word and subsequently copied to archive storage by a repository’s Ingest program, the creatingApplication is Word, not the Ingest program.).freeze],
+      comment: ["Definition: A designation for the name of the software program that created the object.".freeze, "Example: MSWord".freeze, "Usage Notes: The creatingApplication is the application that created the object in its current format, not the application that created the copy written to storage. For example, if a document is created by Microsoft Word and subsequently copied to archive storage by a repository’s Ingest program, the creatingApplication is Word, not the Ingest program.".freeze],
       domain: "premis:CreatingApplication".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasCreatingApplicationVersion,
-      comment: [%(Definition: The version of the software program that created the object.).freeze, %(Example: 2000).freeze],
+      comment: ["Definition: The version of the software program that created the object.".freeze, "Example: 2000".freeze],
       domain: "premis:CreatingApplication".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasDateCreatedByApplication,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The actual or approximate date and time the object was created.).freeze, %(Example: 2001-10-26T19:32:52+00:00).freeze, %(Usage Notes: Use the most precise date available.
-This is the date the object was created by the creating application, not the date any copy was made externally or by the repository. For example, if a file is created by Microsoft Word in 2001 and two copies are made in 2003, the dateCreatedByApplication of all three files is 2001. The date a file is written to storage can be recorded as an Event.
-If the object itself contains internal creation and modification dates, the modification date should be used as dateCreatedByApplication.
-If the application is a Web harvester capturing an object at a point of time, use for date captured.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The actual or approximate date and time the object was created.".freeze, "Example: 2001-10-26T19:32:52+00:00".freeze, "Usage Notes: Use the most precise date available.\nThis is the date the object was created by the creating application, not the date any copy was made externally or by the repository. For example, if a file is created by Microsoft Word in 2001 and two copies are made in 2003, the dateCreatedByApplication of all three files is 2001. The date a file is written to storage can be recorded as an Event.\nIf the object itself contains internal creation and modification dates, the modification date should be used as dateCreatedByApplication.\nIf the application is a Web harvester capturing an object at a point of time, use for date captured.".freeze],
       domain: "premis:CreatingApplication".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1705,13 +1625,13 @@ If the application is a Web harvester capturing an object at a point of time, us
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasDependencyName,
-      comment: [%(Definition: A designation for a component or associated file needed by the representation or file.).freeze, %(Example: Additional Element Set for Language Corpora).freeze, %(Rationale: It may not be self-evident from the dependencyIdentifier what the name of the object actually is.).freeze],
+      comment: ["Definition: A designation for a component or associated file needed by the representation or file.".freeze, "Example: Additional Element Set for Language Corpora".freeze, "Rationale: It may not be self-evident from the dependencyIdentifier what the name of the object actually is.".freeze],
       domain: "premis:Dependency".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEndDate,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The ending date of the permission granted.).freeze, %(Usage Notes: Use “0000-00-00T00:00:00+00:00” for an open ended term of grant. Omit endDate if the ending date is unknown or the permission statement applies to many objects with different end dates.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The ending date of the permission granted.".freeze, "Usage Notes: Use “0000-00-00T00:00:00+00:00” for an open ended term of grant. Omit endDate if the ending date is unknown or the permission statement applies to many objects with different end dates.".freeze],
       domain: "premis:ApplicableDates".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1723,7 +1643,7 @@ If the application is a Web harvester capturing an object at a point of time, us
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEnvironmentCharacteristic,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentCharacteristic).freeze, %(Definition: An assessment of the extent to which the described environment supports its purpose.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: If multiple environments are described, this element can help to distinguish among them.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentCharacteristic".freeze, "Definition: An assessment of the extent to which the described environment supports its purpose.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: If multiple environments are described, this element can help to distinguish among them.".freeze],
       domain: "premis:Environment".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1733,15 +1653,13 @@ If the application is a Web harvester capturing an object at a point of time, us
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasEnvironmentNote,
-      comment: [%(Definition: Additional information about the environment.).freeze, %(Example: This environment assumes that the PDF will be stored locally
-and used with a standalone PDF reader.).freeze, %(Rationale: There may be a need to give a textual description of the environment for additional explanation.).freeze, %(Usage Notes: This note could be used to record the context of the environment information. For example, if a file can be rendered through a PC client application or through a browser with a plug-in, this note could be used to identify which situation applies.
-The note should not be used for a textual description of environment information recorded more rigorously elsewhere.).freeze],
+      comment: ["Definition: Additional information about the environment.".freeze, "Example: This environment assumes that the PDF will be stored locally\nand used with a standalone PDF reader.".freeze, "Rationale: There may be a need to give a textual description of the environment for additional explanation.".freeze, "Usage Notes: This note could be used to record the context of the environment information. For example, if a file can be rendered through a PC client application or through a browser with a plug-in, this note could be used to identify which situation applies.\nThe note should not be used for a textual description of environment information recorded more rigorously elsewhere.".freeze],
       domain: "premis:Environment".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEnvironmentPurpose,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentPurpose).freeze, %(Definition: The use\(s\) supported by the specified environment.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/environmentPurpose".freeze, "Definition: The use(s) supported by the specified environment.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: Different environments can support different uses of objects. For example, the environment needed to edit and modify a file can be quite different than the environment needed to render it.".freeze],
       domain: "premis:Environment".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1751,7 +1669,7 @@ The note should not be used for a textual description of environment information
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEvent,
-      comment: [%(Definition: The event associated with the object or an agent.).freeze, %(Usage Notes: Use to link to events that are not associated with relationships between objects, such as format validation, virus checking, etc.).freeze],
+      comment: ["Definition: The event associated with the object or an agent.".freeze, "Usage Notes: Use to link to events that are not associated with relationships between objects, such as format validation, virus checking, etc.".freeze],
       domain: term(
           type: "owl:Class".freeze,
           unionOf: list("premis:Agent".freeze, "premis:Object".freeze)
@@ -1761,21 +1679,19 @@ The note should not be used for a textual description of environment information
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEventDateTime,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The single date and time, or date and time range, at or during which the event occurred.).freeze, %(Example: 2001-10-26T19:32:52+00:00).freeze, %(Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The single date and time, or date and time range, at or during which the event occurred.".freeze, "Example: 2001-10-26T19:32:52+00:00".freeze, "Usage Notes: Recommended practice is to record the most specific time possible and to designate the time zone.".freeze],
       domain: "premis:Event".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasEventDetail,
-      comment: [%(Definition: Additional information about the event.).freeze, %(Examples: Object permanently withdrawn by request of Caroline Hunt, 
-Program=“MIGJP2JP2K”; version=“2.2”).freeze, %(Usage Notes: eventDetail is not intended to be processed by machine. It may record any information about an event and/or point to information stored elsewhere.).freeze],
+      comment: ["Definition: Additional information about the event.".freeze, "Examples: Object permanently withdrawn by request of Caroline Hunt, \nProgram=“MIGJP2JP2K”; version=“2.2”".freeze, "Usage Notes: eventDetail is not intended to be processed by machine. It may record any information about an event and/or point to information stored elsewhere.".freeze],
       domain: "premis:Event".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasEventOutcome,
-      comment: [%(Data Constraint: Value should be taken from a controlled vocabulary.).freeze, %(Definition: A categorization of the overall result of the event in terms of success, partial success, or failure.).freeze, %(Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]).freeze, %(Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.).freeze, %(Usage Notes: Recommended practice is to use a controlled vocabulary that a system can act upon automatically. More detail about the outcome may be recorded in eventOutcomeDetail.
-Recommended practice is to define events with sufficient granularity that each event has a single outcome.).freeze],
+      comment: ["Data Constraint: Value should be taken from a controlled vocabulary.".freeze, "Definition: A categorization of the overall result of the event in terms of success, partial success, or failure.".freeze, "Examples: 00 [a code meaning “action successfully completed”], CV-01 [a code meaning “checksum validated”]".freeze, "Rationale: A coded way of representing the outcome of an event may be useful for machine processing and reporting. If, for example, a fixity check fails, the event record provides both an actionable and a permanent record.".freeze, "Usage Notes: Recommended practice is to use a controlled vocabulary that a system can act upon automatically. More detail about the outcome may be recorded in eventOutcomeDetail.\nRecommended practice is to define events with sufficient granularity that each event has a single outcome.".freeze],
       domain: "premis:EventOutcomeInformation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1787,7 +1703,7 @@ Recommended practice is to define events with sufficient granularity that each e
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEventOutcomeDetailNote,
-      comment: [%(Definition: A detailed description of the result or product of the event in textual form.).freeze, %(Examples: LZW compressed file, Non-standard tags found in header).freeze, %(Rationale: Additional information in textual form may be needed about the outcome of the event.).freeze],
+      comment: ["Definition: A detailed description of the result or product of the event in textual form.".freeze, "Examples: LZW compressed file, Non-standard tags found in header".freeze, "Rationale: Additional information in textual form may be needed about the outcome of the event.".freeze],
       domain: "premis:EventOutcomeDetail".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1799,7 +1715,7 @@ Recommended practice is to define events with sufficient granularity that each e
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEventRelatedAgent,
-      comment: [%(Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.).freeze, %(This propety links a Event instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.).freeze],
+      comment: ["Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.".freeze, "This propety links a Event instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.".freeze],
       domain: "premis:Event".freeze,
       range: "premis:Agent".freeze,
       "rdfs:seeAlso": "http://id.loc.gov/vocabulary/preservation/eventRelatedAgentRole".freeze,
@@ -1807,7 +1723,7 @@ Recommended practice is to define events with sufficient granularity that each e
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "unstable".freeze
     property :hasEventRelatedObject,
-      comment: [%(Definition: Information about an object associated with an event.).freeze, %(Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.).freeze, %(Rationale: Digital provenance often requires that relationships between objects and events are documented.).freeze],
+      comment: ["Definition: Information about an object associated with an event.".freeze, "Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.".freeze, "Rationale: Digital provenance often requires that relationships between objects and events are documented.".freeze],
       domain: "premis:Event".freeze,
       range: "premis:Object".freeze,
       "rdfs:seeAlso": ["Event class definition and Object class definition".freeze, "http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole".freeze],
@@ -1815,7 +1731,7 @@ Recommended practice is to define events with sufficient granularity that each e
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasEventType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/eventType).freeze, %(Definition: A categorization of the nature of the event.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: Categorizing events will aid the preservation repository in machine processing of event information, particularly in reporting.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/eventType".freeze, "Definition: A categorization of the nature of the event.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: Categorizing events will aid the preservation repository in machine processing of event information, particularly in reporting.".freeze],
       domain: "premis:Event".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1846,13 +1762,13 @@ Recommended practice is to define events with sufficient granularity that each e
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatName,
-      comment: [%(Data Constraint: Value should be taken from a controlled vocabulary.).freeze, %(Definition: A designation of the format of the file or bitstream.).freeze, %(Examples: Text/sgml, image/tiff/geotiff, Adobe PDF, DES, PGP, base64, unknown, LaTex).freeze, %(Usage Notes: For unidentified formats, formatName may be recorded as “unknown”.).freeze],
+      comment: ["Data Constraint: Value should be taken from a controlled vocabulary.".freeze, "Definition: A designation of the format of the file or bitstream.".freeze, "Examples: Text/sgml, image/tiff/geotiff, Adobe PDF, DES, PGP, base64, unknown, LaTex".freeze, "Usage Notes: For unidentified formats, formatName may be recorded as “unknown”.".freeze],
       domain: "premis:FormatDesignation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatNote,
-      comment: [%(Definition: Additional information about format.).freeze, %(Examples: tentative identification, disjunction, multiple format identifications found).freeze, %(Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.).freeze, %(Usage Notes: The formatNote may contain free text, a reference pointer, or a value from a controlled list.).freeze],
+      comment: ["Definition: Additional information about format.".freeze, "Examples: tentative identification, disjunction, multiple format identifications found".freeze, "Rationale: Qualifying information may be needed to supplement format designation and registry information or record a status for identification.".freeze, "Usage Notes: The formatNote may contain free text, a reference pointer, or a value from a controlled list.".freeze],
       domain: "premis:Format".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
@@ -1864,18 +1780,18 @@ Recommended practice is to define events with sufficient granularity that each e
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatRegistryKey,
-      comment: [%(Definition: The unique key used to reference an entry for this format in a format registry.).freeze, %(Examples: info:gdfr/fred/f/tiff, TIFF/6.0).freeze],
+      comment: ["Definition: The unique key used to reference an entry for this format in a format registry.".freeze, "Examples: info:gdfr/fred/f/tiff, TIFF/6.0".freeze],
       domain: "premis:FormatRegistry".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatRegistryName,
-      comment: [%(Definition: A designation identifying the referenced format registry.).freeze, %(Examples: PRONOM, www.nationalarchives.gov.uk/pronom, Representation Information Registry Repository, FRED: A format registry demonstration, release 0.07).freeze, %(Usage Notes: This can be a formal name, internally used name, or URI.).freeze],
+      comment: ["Definition: A designation identifying the referenced format registry.".freeze, "Examples: PRONOM, www.nationalarchives.gov.uk/pronom, Representation Information Registry Repository, FRED: A format registry demonstration, release 0.07".freeze, "Usage Notes: This can be a formal name, internally used name, or URI.".freeze],
       domain: "premis:FormatRegistry".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatRegistryRole,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/formatRegistryRole).freeze, %(Definition: The purpose or expected use of the registry.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: The same format may be defined in different registries for different purposes. For example, one registry may give detailed format specifications while another has profile information. If multiple registries are recorded, this semantic unit can be used to distinguish among them.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/formatRegistryRole".freeze, "Definition: The purpose or expected use of the registry.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: The same format may be defined in different registries for different purposes. For example, one registry may give detailed format specifications while another has profile information. If multiple registries are recorded, this semantic unit can be used to distinguish among them.".freeze],
       domain: "premis:FormatRegistry".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1885,7 +1801,7 @@ Recommended practice is to define events with sufficient granularity that each e
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasFormatVersion,
-      comment: [%(Definition: The version of the format named in formatName.).freeze, %(Examples: 6.0, 2003).freeze, %(Rationale: Many authority lists of format names are not granular enough to indicate version, for example, MIME Media types.).freeze, %(Usage Notes: If the format is versioned, formatVersion should be recorded. It can be either a numeric or chronological designation.).freeze],
+      comment: ["Definition: The version of the format named in formatName.".freeze, "Examples: 6.0, 2003".freeze, "Rationale: Many authority lists of format names are not granular enough to indicate version, for example, MIME Media types.".freeze, "Usage Notes: If the format is versioned, formatVersion should be recorded. It can be either a numeric or chronological designation.".freeze],
       domain: "premis:FormatDesignation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -1897,20 +1813,19 @@ Recommended practice is to define events with sufficient granularity that each e
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasHardwareName,
-      comment: [%(Definition: Manufacturer, model, and version \(if applicable\) of the hardware.).freeze, %(Examples: Intel Pentium III, 1 GB DRAM, Windows XPcompatible joystick).freeze, %(Usage Notes: Include manufacturer when this helps to identify or disambiguate the product.
-Include version for firmware or other components where that information is pertinent.).freeze],
+      comment: ["Definition: Manufacturer, model, and version (if applicable) of the hardware.".freeze, "Examples: Intel Pentium III, 1 GB DRAM, Windows XPcompatible joystick".freeze, "Usage Notes: Include manufacturer when this helps to identify or disambiguate the product.\nInclude version for firmware or other components where that information is pertinent.".freeze],
       domain: "premis:Hardware".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasHardwareOtherInformation,
-      comment: [%(Definition: Additional requirements or instructions related to the hardware referenced in hwName.).freeze, %(Examples: 32MB minimum, Required RAM for Apache is unknown).freeze, %(Rationale: For hardware, the amount of computing resource needed \(such as memory, storage, processor speed, etc.\) may need to be documented. In addition, more detailed instructions may be needed to install and/or operate the hardware.).freeze, %(Usage Notes: This could be an identifier or URI used to point to hardware documentation.).freeze],
+      comment: ["Definition: Additional requirements or instructions related to the hardware referenced in hwName.".freeze, "Examples: 32MB minimum, Required RAM for Apache is unknown".freeze, "Rationale: For hardware, the amount of computing resource needed (such as memory, storage, processor speed, etc.) may need to be documented. In addition, more detailed instructions may be needed to install and/or operate the hardware.".freeze, "Usage Notes: This could be an identifier or URI used to point to hardware documentation.".freeze],
       domain: "premis:Hardware".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasHardwareType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/hardwareType).freeze, %(Definition: Class or category of the hardware.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/hardwareType".freeze, "Definition: Class or category of the hardware.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:Hardware".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1928,25 +1843,25 @@ Include version for firmware or other components where that information is perti
       type: ["owl:InverseFunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasIdentifierType,
-      comment: [%(Data Constraint: Value should be taken from controlled vocabulary.).freeze, %(Definition: A designation of the domain within which the identifier is unique.).freeze, %(Examples: DLC, DRS, hdl:4263537).freeze, %(Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.).freeze, %(Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.).freeze],
+      comment: ["Data Constraint: Value should be taken from controlled vocabulary.".freeze, "Definition: A designation of the domain within which the identifier is unique.".freeze, "Examples: DLC, DRS, hdl:4263537".freeze, "Rationale: Identifier values cannot be assumed to be unique across domains. The combination of identifierType and identifierValue should ensure uniqueness.".freeze, "Usage Notes: The type of the identifier may be implicit within the repository as long it can be explicitly communicated when the item is disseminated outside of it.".freeze],
       domain: "premis:Identifier".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasIdentifierValue,
-      comment: [%(Defnition: The value of the Identifier.).freeze, %(Examples: 0000000312 \(Representation\), IU2440 \(File\), WAC1943.56 \(File\), http://nrs.harvard.edu/urn-3:FHCL.Loeb:sal \(File\), IU2440-1 \(Bitstream\)).freeze],
+      comment: ["Defnition: The value of the Identifier.".freeze, "Examples: 0000000312 (Representation), IU2440 (File), WAC1943.56 (File), http://nrs.harvard.edu/urn-3:FHCL.Loeb:sal (File), IU2440-1 (Bitstream)".freeze],
       domain: "premis:Identifier".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasInhibitorKey,
-      comment: [%(Definition: The decryption key or password.).freeze, %(Example: [DES decryption key]).freeze, %(Usage Notes: The key should be provided if known. However, it is not advisable to actually store the inhibitorKey in plain text in an unsecure database.).freeze],
+      comment: ["Definition: The decryption key or password.".freeze, "Example: [DES decryption key]".freeze, "Usage Notes: The key should be provided if known. However, it is not advisable to actually store the inhibitorKey in plain text in an unsecure database.".freeze],
       domain: "premis:Inhibitors".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasInhibitorTarget,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorTarget).freeze, %(Definition: The content or function protected by the inhibitor.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorTarget".freeze, "Definition: The content or function protected by the inhibitor.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:Inhibitors".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1956,7 +1871,7 @@ Include version for firmware or other components where that information is perti
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasInhibitorType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorType).freeze, %(Definition: The inhibitor method employed.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/inhibitorType".freeze, "Definition: The inhibitor method employed.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:Inhibitors".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -1972,7 +1887,7 @@ Include version for firmware or other components where that information is perti
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasIntellectualEntity,
-      comment: [%(Definition: An intellectual entity associated with the object.).freeze, %(Usage Notes: Use to link to an intellectual entity that is related to the object. This may be a link to descriptive metadata that describes the intellectual entity or some other surrogate for it that can be referenced. This link will likely be to an identifier of an object that is at a higher conceptual level than the object for which the metadata is provided, for example, to a collection or parent object.).freeze],
+      comment: ["Definition: An intellectual entity associated with the object.".freeze, "Usage Notes: Use to link to an intellectual entity that is related to the object. This may be a link to descriptive metadata that describes the intellectual entity or some other surrogate for it that can be referenced. This link will likely be to an identifier of an object that is at a higher conceptual level than the object for which the metadata is provided, for example, to a collection or parent object.".freeze],
       domain: "premis:Object".freeze,
       range: "premis:IntellectualEntity".freeze,
       type: "owl:ObjectProperty".freeze,
@@ -1983,19 +1898,19 @@ Include version for firmware or other components where that information is perti
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "unstable".freeze
     property :hasLicenseTerms,
-      comment: [%(Definition: Text describing the license or agreement by which permission was granted.).freeze, %(Usage Notes: This could contain the actual text of the license or agreement or a paraphrase or summary.).freeze],
+      comment: ["Definition: Text describing the license or agreement by which permission was granted.".freeze, "Usage Notes: This could contain the actual text of the license or agreement or a paraphrase or summary.".freeze],
       domain: "premis:LicenseInformation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasMessageDigest,
-      comment: [%(Definition: The output of the message digest algorithm.).freeze, %(Example: 7c9b35da4f2ebd436f1cf88e5a39b3a257edf4a22be3c955ac49da2e2107b67a1924419563).freeze, %(Rationale: This must be stored so that it can be compared in future fixity checks.).freeze],
+      comment: ["Definition: The output of the message digest algorithm.".freeze, "Example: 7c9b35da4f2ebd436f1cf88e5a39b3a257edf4a22be3c955ac49da2e2107b67a1924419563".freeze, "Rationale: This must be stored so that it can be compared in future fixity checks.".freeze],
       domain: "premis:Fixity".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasMessageDigestAlgorithm,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions).freeze, %(Definition: The specific algorithm used to construct the message digest for the digital object.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/cryptographicHashFunctions".freeze, "Definition: The specific algorithm used to construct the message digest for the digital object.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze],
       domain: "premis:Fixity".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -2005,13 +1920,13 @@ Include version for firmware or other components where that information is perti
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasMessageDigestOriginator,
-      comment: [%(Creation / Maintenance Notes: If the calculation of the initial message digest is treated by the repository as an Event, this information could be obtained from an Event record.).freeze, %(Definition: The agent that created the original message digest that is compared in a fixity check.).freeze, %(Examples: DRS, A0000978).freeze, %(Rationale: A preservation repository may ingest files that have had message digests calculated by the submitter; checking these ensures that the file as received is the same as the file as sent. The repository may also ingest files that do not have message digests, and so must calculate the initial value upon ingest. It can be useful to know who calculated the initial value of the message digest.).freeze, %(Usage Notes: The originator of the message digest could be represented by a string representing the agent \(e.g., “NRS” referring to the archive itself\) or a pointer to an agent description \(e.g., “A0000987” taken here to be an agentIdentifierValue\).).freeze],
+      comment: ["Creation / Maintenance Notes: If the calculation of the initial message digest is treated by the repository as an Event, this information could be obtained from an Event record.".freeze, "Definition: The agent that created the original message digest that is compared in a fixity check.".freeze, "Examples: DRS, A0000978".freeze, "Rationale: A preservation repository may ingest files that have had message digests calculated by the submitter; checking these ensures that the file as received is the same as the file as sent. The repository may also ingest files that do not have message digests, and so must calculate the initial value upon ingest. It can be useful to know who calculated the initial value of the message digest.".freeze, "Usage Notes: The originator of the message digest could be represented by a string representing the agent (e.g., “NRS” referring to the archive itself) or a pointer to an agent description (e.g., “A0000987” taken here to be an agentIdentifierValue).".freeze],
       domain: "premis:Fixity".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasObject,
-      comment: [%(Definition: Information about an object associated with an event or rightsstatement.).freeze, %(Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.).freeze, %(Rationale: Digital provenance often requires that relationships between objects and events are documented. / Rights statements must be associated with the objects to which they pertain, either by linking from the rights statement to the object\(s\) or by linking from the object\(s\) to the rights statement. This provides the mechanism for the link from the rights statement to an object. For denoting the role of the object, when related to an event,one can extend this ontology be defining your own subproperties, such as those given by http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole.).freeze],
+      comment: ["Definition: Information about an object associated with an event or rightsstatement.".freeze, "Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.".freeze, "Rationale: Digital provenance often requires that relationships between objects and events are documented. / Rights statements must be associated with the objects to which they pertain, either by linking from the rights statement to the object(s) or by linking from the object(s) to the rights statement. This provides the mechanism for the link from the rights statement to an object. For denoting the role of the object, when related to an event,one can extend this ontology be defining your own subproperties, such as those given by http://id.loc.gov/vocabulary/preservation/eventRelatedObjectRole.".freeze],
       domain: term(
           type: "owl:Class".freeze,
           unionOf: list("premis:Event".freeze, "premis:RightsStatement".freeze)
@@ -2030,7 +1945,7 @@ Include version for firmware or other components where that information is perti
       type: ["owl:InverseFunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasOriginalName,
-      comment: [%(Creation / Maintenance Notes: This value would always be supplied to the repository by the submitter or harvesting application. How much of the file path to preserve would be up to the repository.).freeze, %(Definition: The name of the object as submitted to or harvested by the repository, before any renaming by the repository.).freeze, %(Example: N419.pdf).freeze, %(Rationale: The name used within the preservation repository may not be known outside of the repository. A depositor might need to request a file by its original name. Also, the repository may need to reconstruct internal links for dissemination.).freeze, %(Usage Notes: This is the name of the object as designated in the Submission Information Package \(SIP\). The object may have other names in different contexts. When two repositories are exchanging content, it would be important for the receiving repository to know and record the name of the representation at the originating repository. In the case of representations, this may be a directory name.).freeze],
+      comment: ["Creation / Maintenance Notes: This value would always be supplied to the repository by the submitter or harvesting application. How much of the file path to preserve would be up to the repository.".freeze, "Definition: The name of the object as submitted to or harvested by the repository, before any renaming by the repository.".freeze, "Example: N419.pdf".freeze, "Rationale: The name used within the preservation repository may not be known outside of the repository. A depositor might need to request a file by its original name. Also, the repository may need to reconstruct internal links for dissemination.".freeze, "Usage Notes: This is the name of the object as designated in the Submission Information Package (SIP). The object may have other names in different contexts. When two repositories are exchanging content, it would be important for the receiving repository to know and record the name of the representation at the originating repository. In the case of representations, this may be a directory name.".freeze],
       domain: term(
           type: "owl:Class".freeze,
           unionOf: list("premis:File".freeze, "premis:Representation".freeze)
@@ -2048,24 +1963,19 @@ Include version for firmware or other components where that information is perti
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasPreservationLevelDateAssigned,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The date, or date and time, when a particular preservationLevelValue was assigned to the object.).freeze, %(Examples: 2001-10-26T19:32:52+00:00).freeze, %(Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The date, or date and time, when a particular preservationLevelValue was assigned to the object.".freeze, "Examples: 2001-10-26T19:32:52+00:00".freeze, "Rationale: The preservationLevel applicable to an object is expected to be reviewed and changed over time, in response to changes in repository preservation requirements, policies, or capabilities relevant to the object. The date that the current preservationLevelValue was assigned aids review of decisions.".freeze],
       domain: "premis:PreservationLevel".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasPreservationLevelRationale,
-      comment: [%(Definition: The reason a particular preservationLevelValue was applied to 
-    the object.).freeze, %(Examples: user pays, legislation, defective file, bit-level preservation only available for this format).freeze, %(Rationale: Application of a particular preservationLevelValue may require justification, especially if it differs from that usually applied according to repository policy.).freeze, %(Usage Notes: This optional semantic unit records the reason for applying the preservationLevelValue.
-This information can be particularly important when the assigned preservationLevelValue differs from usual repository policy.
-For example, a repository may normally assign a preservationLevelValue of “full preservation” for JPEG2000 files, but detects that a particular file is defective. This may mean that the repository’s preservation strategy for JPEG2000 may not be effective for this particular file, so the repository may assign a preservationLevelValue of “bit-level preservation” to this file, recording “defective file” as the rationale.
-Similarly, legislative requirements or contractual agreements may require a higher level of preservation to be assigned to a particular object than would be assigned to that class of object according to usual policy. In this case, the rationale for the assignment may be recorded as “legislation” or “user pays”, for example.
-preservationLevelRationale may be repeated if more than one reason needs to be recorded.).freeze],
+      comment: ["Definition: The reason a particular preservationLevelValue was applied to \n    the object.".freeze, "Examples: user pays, legislation, defective file, bit-level preservation only available for this format".freeze, "Rationale: Application of a particular preservationLevelValue may require justification, especially if it differs from that usually applied according to repository policy.".freeze, "Usage Notes: This optional semantic unit records the reason for applying the preservationLevelValue.\nThis information can be particularly important when the assigned preservationLevelValue differs from usual repository policy.\nFor example, a repository may normally assign a preservationLevelValue of “full preservation” for JPEG2000 files, but detects that a particular file is defective. This may mean that the repository’s preservation strategy for JPEG2000 may not be effective for this particular file, so the repository may assign a preservationLevelValue of “bit-level preservation” to this file, recording “defective file” as the rationale.\nSimilarly, legislative requirements or contractual agreements may require a higher level of preservation to be assigned to a particular object than would be assigned to that class of object according to usual policy. In this case, the rationale for the assignment may be recorded as “legislation” or “user pays”, for example.\npreservationLevelRationale may be repeated if more than one reason needs to be recorded.".freeze],
       domain: "premis:PreservationLevel".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasPreservationLevelRole,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/preservationLevelRole).freeze, %(Definition: A value indicating the context in which a set of preservation options is applicable.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: Repositories may assign preservationLevelValues in different contexts which must be differentiated, and may need to record more than one context.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/preservationLevelRole".freeze, "Definition: A value indicating the context in which a set of preservation options is applicable.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: Repositories may assign preservationLevelValues in different contexts which must be differentiated, and may need to record more than one context.".freeze],
       domain: "premis:PreservationLevel".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -2075,32 +1985,31 @@ preservationLevelRationale may be repeated if more than one reason needs to be r
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasPreservationLevelValue,
-      comment: [%(Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata.).freeze, %(Data Constraint: Value should be taken from a controlled vocabulary.).freeze, %(Definition: A value indicating the set of preservation functions expected to be applied to the object.).freeze, %(Examples: bit-level, full, fully supported with future migrations \(File\), 0).freeze, %(Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc.).freeze, %(Usage Notes: Only one preservationLevelValue may be recorded per preservationLevel container. If a further preservationLevelValue applies to the object in a different context, a separate preservationLevel container should be repeated.).freeze],
+      comment: ["Creation / Maintenance Notes: The preservation level may be assigned by the repository or requested by the depositor and submitted as metadata.".freeze, "Data Constraint: Value should be taken from a controlled vocabulary.".freeze, "Definition: A value indicating the set of preservation functions expected to be applied to the object.".freeze, "Examples: bit-level, full, fully supported with future migrations (File), 0".freeze, "Rationale: Some preservation repositories will offer multiple preservation options depending on factors such as the value or uniqueness of the material, the “preservability” of the format, the amount the customer is willing to pay, etc.".freeze, "Usage Notes: Only one preservationLevelValue may be recorded per preservationLevel container. If a further preservationLevelValue applies to the object in a different context, a separate preservationLevel container should be repeated.".freeze],
       domain: "premis:PreservationLevel".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasRelatedObject,
-      comment: %(Definition: This property related to all object belonging to a RelatedObjectIdentification to describe the related objects as an aggregation.).freeze,
+      comment: "Definition: This property related to all object belonging to a RelatedObjectIdentification to describe the related objects as an aggregation.".freeze,
       domain: "premis:RelatedObjectIdentification".freeze,
       range: "premis:Object".freeze,
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRelatedObjectSequence,
-      comment: [%(Definition: The order of the related object relative to other objects with the same
-type of relationship.).freeze, %(Rationale: This semantic unit is particularly useful for structural relationships. In order to reconstruct a representation, it may be necessary to know the order of components with sibling or part-whole relationships. For example, to render a page-image book, it is necessary to know the order of files representing pages.).freeze],
+      comment: ["Definition: The order of the related object relative to other objects with the same\ntype of relationship.".freeze, "Rationale: This semantic unit is particularly useful for structural relationships. In order to reconstruct a representation, it may be necessary to know the order of components with sibling or part-whole relationships. For example, to render a page-image book, it is necessary to know the order of files representing pages.".freeze],
       domain: "premis:RelatedObjectIdentification".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRelatedStatuteInformation,
-      comment: %(Definition: This property is used to relate certain StatuteInformation instances. The rationale for this is that in the PREMIS data dictionary, a RightsStatement instance can consist of several StatuteInformation instances. In the PREMIS OWL ontology, the StatuteInformation class is subclassed to RightsStatement. The restore the relation between the grouped StatuteInformation instances of a RightsStatement of the PREMIS data dictionary, this property is used is PREMIS OWL.).freeze,
+      comment: "Definition: This property is used to relate certain StatuteInformation instances. The rationale for this is that in the PREMIS data dictionary, a RightsStatement instance can consist of several StatuteInformation instances. In the PREMIS OWL ontology, the StatuteInformation class is subclassed to RightsStatement. The restore the relation between the grouped StatuteInformation instances of a RightsStatement of the PREMIS data dictionary, this property is used is PREMIS OWL.".freeze,
       domain: "premis:StatuteInformation".freeze,
       range: "premis:StatuteInformation".freeze,
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRelationship,
-      comment: [%(Definition: This property links one object to one or more other objects.).freeze, %(Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.).freeze, %(The LOC will provide a SKOS vocabulary, where the concepts can also be used as object properties at http://id.loc.gov/. These relationships will capture the relationship type and subtype. One can define its own relationships, but for interoperability reasons, these should be linked to or made a subproperty of the properties of the LOC vocabulary.).freeze],
+      comment: ["Definition: This property links one object to one or more other objects.".freeze, "Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.".freeze, "The LOC will provide a SKOS vocabulary, where the concepts can also be used as object properties at http://id.loc.gov/. These relationships will capture the relationship type and subtype. One can define its own relationships, but for interoperability reasons, these should be linked to or made a subproperty of the properties of the LOC vocabulary.".freeze],
       domain: "premis:Object".freeze,
       range: term(
           type: "owl:Class".freeze,
@@ -2110,7 +2019,7 @@ type of relationship.).freeze, %(Rationale: This semantic unit is particularly u
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "testing".freeze
     property :hasRestriction,
-      comment: [%(Definition: A condition or limitation on the act.).freeze, %(Examples: No more than three, Allowed only after one year of archival retention has elapsed, Rightsholder must be notified after completion of act).freeze],
+      comment: ["Definition: A condition or limitation on the act.".freeze, "Examples: No more than three, Allowed only after one year of archival retention has elapsed, Rightsholder must be notified after completion of act".freeze],
       domain: "premis:RightsGranted".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
@@ -2122,7 +2031,7 @@ type of relationship.).freeze, %(Rationale: This semantic unit is particularly u
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRightsDocumentationRole,
-      comment: [%(Definition: This property denotes the role of the related documentation. The value must be taken from a skos vocabulary. A value indicating the purpose or expected use of the documentation being identified.).freeze, %(Rationale: This information distinguishes the purpose of the supporting documentation especially when there are multiple documentation identifiers.).freeze],
+      comment: ["Definition: This property denotes the role of the related documentation. The value must be taken from a skos vocabulary. A value indicating the purpose or expected use of the documentation being identified.".freeze, "Rationale: This information distinguishes the purpose of the supporting documentation especially when there are multiple documentation identifiers.".freeze],
       domain: "premis:RightsDocumentation".freeze,
       range: "skos:Concept".freeze,
       type: "owl:ObjectProperty".freeze,
@@ -2134,13 +2043,13 @@ type of relationship.).freeze, %(Rationale: This semantic unit is particularly u
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRightsGrantedNote,
-      comment: [%(Definition: Additional information about the rights granted.).freeze, %(Rationale: A textual description of the rights granted may be needed for additional explanation.).freeze, %(Usage Notes: This semantic unit may include a statement about risk assessment, for example, when a repository is not certain about what permissions have been granted.).freeze],
+      comment: ["Definition: Additional information about the rights granted.".freeze, "Rationale: A textual description of the rights granted may be needed for additional explanation.".freeze, "Usage Notes: This semantic unit may include a statement about risk assessment, for example, when a repository is not certain about what permissions have been granted.".freeze],
       domain: "premis:RightsGranted".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRightsRelatedAgent,
-      comment: [%(Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.).freeze, %(This propety links a RightsStatement instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.).freeze],
+      comment: ["Extensions: One can extend this property to use more fine grained properties by defining the fine grained properties as subproperties of this property.".freeze, "This propety links a RightsStatement instance to an Agent instance. Via this property a distinction can be made in the linkingAgent properties based on the domain.".freeze],
       domain: "premis:RightsStatement".freeze,
       range: "premis:Agent".freeze,
       "rdfs:seeAlso": "http://id.loc.gov/vocabulary/preservation/rightsRelatedAgentRole".freeze,
@@ -2148,7 +2057,7 @@ type of relationship.).freeze, %(Rationale: This semantic unit is particularly u
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "unstable".freeze
     property :hasRightsStatement,
-      comment: [%(Definition: A rights statement associated with the object.).freeze, %(Rationale: A repository may choose to link from a rights statement to an object or from an object to a rights statement or both.).freeze],
+      comment: ["Definition: A rights statement associated with the object.".freeze, "Rationale: A repository may choose to link from a rights statement to an object or from an object to a rights statement or both.".freeze],
       domain: term(
           type: "owl:Class".freeze,
           unionOf: list("premis:Agent".freeze, "premis:Object".freeze)
@@ -2158,8 +2067,7 @@ type of relationship.).freeze, %(Rationale: This semantic unit is particularly u
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasRightsStatementNote,
-      comment: [%(Definition: Additional information about the RightsStatement  of an object.).freeze, %(Examples: Copyright expiration expected in 2010 unless renewed.
-License is embedded in XMP block in file header.).freeze],
+      comment: ["Definition: Additional information about the RightsStatement  of an object.".freeze, "Examples: Copyright expiration expected in 2010 unless renewed.\nLicense is embedded in XMP block in file header.".freeze],
       domain: "premis:RightsStatement".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
@@ -2174,7 +2082,7 @@ License is embedded in XMP block in file header.).freeze],
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSignatureEncoding,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/signatureEncoding).freeze, %(Definition: The encoding used for the values of signatureValue, keyInformation.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: These values cannot be interpreted correctly if the encoding is unknown.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/signatureEncoding".freeze, "Definition: The encoding used for the values of signatureValue, keyInformation.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: These values cannot be interpreted correctly if the encoding is unknown.".freeze],
       domain: "premis:Signature".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -2184,32 +2092,31 @@ License is embedded in XMP block in file header.).freeze],
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSignatureMethod,
-      comment: [%(Data Constraint: Values are taken from a SKOS vocabulary).freeze, %(Definition: A designation for the encryption and hash algorithms used for signature generation.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: The same algorithms must be used for signature validation.).freeze],
+      comment: ["Data Constraint: Values are taken from a SKOS vocabulary".freeze, "Definition: A designation for the encryption and hash algorithms used for signature generation.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: The same algorithms must be used for signature validation.".freeze],
       domain: "premis:Signature".freeze,
       range: "skos:Concept".freeze,
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSignatureProperties,
-      comment: [%(Definition: Additional information about the generation of the signature.).freeze, %(Usage Notes: This may include the date/time of signature generation, the serial number of the cryptographic hardware used, or other information related to the generation of the signature. Repositories will likely want to define a suitably granular structure to signatureProperties.).freeze],
+      comment: ["Definition: Additional information about the generation of the signature.".freeze, "Usage Notes: This may include the date/time of signature generation, the serial number of the cryptographic hardware used, or other information related to the generation of the signature. Repositories will likely want to define a suitably granular structure to signatureProperties.".freeze],
       domain: "premis:Signature".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSignatureValidationRules,
-      comment: [%(Definition: The operations to be performed in order to validate the digital signature.).freeze, %(Rationale: The repository should not assume that the procedure for validating any particular signature will be known many years in the future without documentation.).freeze, %(Usage Notes: This may include the canonicalization method used before calculating the message digest, if the object was normalized before signing.
-This value could also be a pointer to archive documentation.).freeze],
+      comment: ["Definition: The operations to be performed in order to validate the digital signature.".freeze, "Rationale: The repository should not assume that the procedure for validating any particular signature will be known many years in the future without documentation.".freeze, "Usage Notes: This may include the canonicalization method used before calculating the message digest, if the object was normalized before signing.\nThis value could also be a pointer to archive documentation.".freeze],
       domain: "premis:Signature".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSignatureValue,
-      comment: [%(Definition: The digital signature; a value generated from the application of a private key to a message digest.).freeze, %(Example: juS5RhJ884qoFR8flVXd/rbrSDVGn40CapgB7qeQiT+rr0NekEQ6BHhUA8dT3+BCTBUQI0dBjlml9lwzENXvS83zRECjzXbMRTUtVZiPZG2pqKPnL2YU3A9645UCjTXU+jgFumv7k78hieAGDzNci+PQ9KRmm//icT7JaYztgt4=).freeze],
+      comment: ["Definition: The digital signature; a value generated from the application of a private key to a message digest.".freeze, "Example: juS5RhJ884qoFR8flVXd/rbrSDVGn40CapgB7qeQiT+rr0NekEQ6BHhUA8dT3+BCTBUQI0dBjlml9lwzENXvS83zRECjzXbMRTUtVZiPZG2pqKPnL2YU3A9645UCjTXU+jgFumv7k78hieAGDzNci+PQ9KRmm//icT7JaYztgt4=".freeze],
       domain: "premis:Signature".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSigner,
-      comment: [%(Definition: The individual, institution, or authority responsible for generating the signature.).freeze, %(Rationale: The signer might also be carried in the keyInformation, but it can be accessed more conveniently if recorded here.).freeze, %(Usage Notes: If the signer is an Agent known to the repository, this property can directly link to this agent. The consequence is punning: a datatype property and object property with the same name, i.e., :signer).freeze],
+      comment: ["Definition: The individual, institution, or authority responsible for generating the signature.".freeze, "Rationale: The signer might also be carried in the keyInformation, but it can be accessed more conveniently if recorded here.".freeze, "Usage Notes: If the signer is an Agent known to the repository, this property can directly link to this agent. The consequence is punning: a datatype property and object property with the same name, i.e., :signer".freeze],
       domain: "premis:Signature".freeze,
       range: ["premis:Agent".freeze, "xsd:string".freeze],
       type: "owl:AnnotationProperty".freeze,
@@ -2221,21 +2128,19 @@ This value could also be a pointer to archive documentation.).freeze],
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSignificantPropertiesType,
-      comment: [%(Definition: The aspect, facet, or attribute of an object about which significant properties are being described.).freeze, %(Examples: content, structure, behavior, page count, page width, typeface, hyperlinks \(representation\), image count \(representation\), color space [for an embedded image] \(bitstream\)).freeze, %(Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.).freeze, %(Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.).freeze],
+      comment: ["Definition: The aspect, facet, or attribute of an object about which significant properties are being described.".freeze, "Examples: content, structure, behavior, page count, page width, typeface, hyperlinks (representation), image count (representation), color space [for an embedded image] (bitstream)".freeze, "Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.".freeze, "Usage Notes: This semantic unit is optional and may be used as part of a facet:detail pair with significantPropertiesValue.".freeze],
       domain: "premis:SignificantProperties".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSignificantPropertiesValue,
-      comment: [%(Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.).freeze, %(Examples: [For a Web page containing animation that is not considered essential] Content only, [For detail associated with a significantPropertiesType of "behavior"] Hyperlinks traversable, [For a Word document with embedded links that are not considered essential] Content only, [For detail associated with significantPropertiesType of "behavior"] Editable, [For detail associated with a significantPropertiesType of "page width"] 210 mm, [For a PDF with an embedded graph, where the lines' color determines the lines' meaning] Color, [For detail associated with a significantPropertiesType of "appearance"] Color).freeze, %(Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.).freeze, %(Usage Notes: If facet:detail pairs are used, the content of significantPropertiesValue should describe the significant properties of object relevant to the aspect, facet, or attribute declared in the significantPropertiesType with which it is paired.
-If facet:detail pairs are not used, significantPropertiesValue may be used to freely describe any characteristic of an object.
-significantPropertiesValue is not repeatable. Multiple significant properties should be described in separate, repeated significantProperties container units.).freeze],
+      comment: ["Definition: Description of the characteristics of a particular object subjectively determined to be important to maintain through preservation actions.".freeze, "Examples: [For a Web page containing animation that is not considered essential] Content only, [For detail associated with a significantPropertiesType of \"behavior\"] Hyperlinks traversable, [For a Word document with embedded links that are not considered essential] Content only, [For detail associated with significantPropertiesType of \"behavior\"] Editable, [For detail associated with a significantPropertiesType of \"page width\"] 210 mm, [For a PDF with an embedded graph, where the lines' color determines the lines' meaning] Color, [For detail associated with a significantPropertiesType of \"appearance\"] Color".freeze, "Rationale: Repositories may choose to describe significant properties based on a particular aspect or attribute of an object.".freeze, "Usage Notes: If facet:detail pairs are used, the content of significantPropertiesValue should describe the significant properties of object relevant to the aspect, facet, or attribute declared in the significantPropertiesType with which it is paired.\nIf facet:detail pairs are not used, significantPropertiesValue may be used to freely describe any characteristic of an object.\nsignificantPropertiesValue is not repeatable. Multiple significant properties should be described in separate, repeated significantProperties container units.".freeze],
       domain: "premis:SignificantProperties".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSize,
-      comment: [%(Creation / Maintenance Notes: Automatically obtained by the repository.).freeze, %(Definition: The size in bytes of the file or bitstream stored in the repository.).freeze, %(Example: 2038937).freeze, %(Rationale: Size is useful for ensuring the correct number of bytes from storage have been retrieved and that an application has enough room to move or process files. It might also be used when billing for storage.).freeze, %(Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.).freeze],
+      comment: ["Creation / Maintenance Notes: Automatically obtained by the repository.".freeze, "Definition: The size in bytes of the file or bitstream stored in the repository.".freeze, "Example: 2038937".freeze, "Rationale: Size is useful for ensuring the correct number of bytes from storage have been retrieved and that an application has enough room to move or process files. It might also be used when billing for storage.".freeze, "Usage Notes: Defining this semantic unit as size in bytes makes it unnecessary to record a unit of measurement. However, for the purpose of data exchange the unit of measurement should be stated or understood by both partners.".freeze],
       domain: "premis:ObjectCharacteristics".freeze,
       range: "xsd:long".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -2247,25 +2152,25 @@ significantPropertiesValue is not repeatable. Multiple significant properties sh
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSoftwareDependency,
-      comment: [%(Definition: The name and, if applicable, version of any software component needed by the software referenced in swName in the context of using this object.).freeze, %(Example: GNU gcc >=2.7.2).freeze, %(Usage Notes: The value should be constructed in a way that is consistent with the construction of swName and swVersion. This semantic unit identifies the software that is needed by what is recorded in swName, for example, a Perl script that depends on a Perl module. In this case the Perl script is listed in swName, with the module in swDependency within a software container.).freeze],
+      comment: ["Definition: The name and, if applicable, version of any software component needed by the software referenced in swName in the context of using this object.".freeze, "Example: GNU gcc >=2.7.2".freeze, "Usage Notes: The value should be constructed in a way that is consistent with the construction of swName and swVersion. This semantic unit identifies the software that is needed by what is recorded in swName, for example, a Perl script that depends on a Perl module. In this case the Perl script is listed in swName, with the module in swDependency within a software container.".freeze],
       domain: "premis:Software".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSoftwareName,
-      comment: [%(Definition: Manufacturer and title of the software application.).freeze, %(Examples: Adobe Photoshop, Adobe Acrobat Reader).freeze, %(Usage Notes: Include manufacturer when this helps to identify or disambiguate the product, for example, use “Adobe Photoshop” rather than “Photoshop.”).freeze],
+      comment: ["Definition: Manufacturer and title of the software application.".freeze, "Examples: Adobe Photoshop, Adobe Acrobat Reader".freeze, "Usage Notes: Include manufacturer when this helps to identify or disambiguate the product, for example, use “Adobe Photoshop” rather than “Photoshop.”".freeze],
       domain: "premis:Software".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSoftwareOtherInformation,
-      comment: [%(Definition: Additional requirements or instructions related to the software referenced in swName.).freeze, %(Example: Install Acroread \(Adobe Acrobat\) first; copy nppdf.so \(the plug-in\) to your Mozilla plug-ins directory, and make sure a copy of \(or symlink to\) Acroread is in your PATH.).freeze, %(Usage Notes: This could be a reliable persistent identifier or URI pointing to software documentation within or outside the repository.).freeze],
+      comment: ["Definition: Additional requirements or instructions related to the software referenced in swName.".freeze, "Example: Install Acroread (Adobe Acrobat) first; copy nppdf.so (the plug-in) to your Mozilla plug-ins directory, and make sure a copy of (or symlink to) Acroread is in your PATH.".freeze, "Usage Notes: This could be a reliable persistent identifier or URI pointing to software documentation within or outside the repository.".freeze],
       domain: "premis:Software".freeze,
       range: "xsd:string".freeze,
       type: "owl:DatatypeProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasSoftwareType,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/softwareType).freeze, %(Definition: Class or category of software.).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: Several different layers of software can be required to support an object.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/softwareType".freeze, "Definition: Class or category of software.".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: Several different layers of software can be required to support an object.".freeze],
       domain: "premis:Software".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,
@@ -2275,31 +2180,31 @@ significantPropertiesValue is not repeatable. Multiple significant properties sh
       type: ["owl:FunctionalProperty".freeze, "owl:ObjectProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasSoftwareVersion,
-      comment: [%(Definition: The version or versions of the software referenced in swName.).freeze, %(Examples: >=2.2.0, 6.0, 2003).freeze, %(Usage Notes: If there is no formal version, the date of issuance can be used.).freeze],
+      comment: ["Definition: The version or versions of the software referenced in swName.".freeze, "Examples: >=2.2.0, 6.0, 2003".freeze, "Usage Notes: If there is no formal version, the date of issuance can be used.".freeze],
       domain: "premis:Software".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasStartDate,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The beginning date of the permission granted.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The beginning date of the permission granted.".freeze],
       domain: "premis:ApplicableDates".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasStatuteCitation,
-      comment: [%(Definition: An identifying designation for the statute.).freeze, %(Examples: Legal Deposit \(Jersey\) Law 200, National Library of New Zealand \(Te Puna Mātauranga o Aotearoa\) Act 2003 no 19 part 4 s 34).freeze, %(Usage Notes: Use standard citation form when applicable.).freeze],
+      comment: ["Definition: An identifying designation for the statute.".freeze, "Examples: Legal Deposit (Jersey) Law 200, National Library of New Zealand (Te Puna Mātauranga o Aotearoa) Act 2003 no 19 part 4 s 34".freeze, "Usage Notes: Use standard citation form when applicable.".freeze],
       domain: "premis:StatuteInformation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasStatuteInformationDeterminationDate,
-      comment: [%(Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime).freeze, %(Definition: The date that the determination was made that the statute authorized the permission\(s\) noted.).freeze, %(Example: 2001-10-26T19:32:52+00:00).freeze, %(Rationale: The permission in question may be the subject of some interpretation. These assessments are made within a specific context and at a specific time. At another time the context, and therefore the assessment, could change. For this reason it can be important to record the date of the decision.).freeze],
+      comment: ["Data Constraint: To aid machine processing, value should use a structured form: xsd:dateTime".freeze, "Definition: The date that the determination was made that the statute authorized the permission(s) noted.".freeze, "Example: 2001-10-26T19:32:52+00:00".freeze, "Rationale: The permission in question may be the subject of some interpretation. These assessments are made within a specific context and at a specific time. At another time the context, and therefore the assessment, could change. For this reason it can be important to record the date of the decision.".freeze],
       domain: "premis:StatuteInformation".freeze,
       range: "xsd:dateTime".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
       "vs:term_status": "stable".freeze
     property :hasStatuteJurisdiction,
-      comment: [%(Data Constraint: Values should be taken from a controlled vocabulary.).freeze, %(Definition: The country or other political body enacting the statute.).freeze, %(Examples: us, de, be).freeze, %(Rationale: The connection between the object and the rights granted is based on jurisdiction.).freeze],
+      comment: ["Data Constraint: Values should be taken from a controlled vocabulary.".freeze, "Definition: The country or other political body enacting the statute.".freeze, "Examples: us, de, be".freeze, "Rationale: The connection between the object and the rights granted is based on jurisdiction.".freeze],
       domain: "premis:StatuteInformation".freeze,
       range: "xsd:string".freeze,
       type: ["owl:DatatypeProperty".freeze, "owl:FunctionalProperty".freeze],
@@ -2314,7 +2219,7 @@ significantPropertiesValue is not repeatable. Multiple significant properties sh
       type: "owl:ObjectProperty".freeze,
       "vs:term_status": "stable".freeze
     property :hasStorageMedium,
-      comment: [%(Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium).freeze, %(Definition: The physical medium on which the object is stored \(e.g., magnetic tape, hard disk, CD-ROM, DVD\).).freeze, %(Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.).freeze, %(Rationale: The repository needs to know the medium on which an object is stored in order to know how and when to do media refreshment and media migration.).freeze],
+      comment: ["Data Constraint: Values are taken from the SKOS vocabulary: http://id.loc.gov/vocabulary/preservation/storageMedium".freeze, "Definition: The physical medium on which the object is stored (e.g., magnetic tape, hard disk, CD-ROM, DVD).".freeze, "Extensions: One can use its own SKOS vocabulary to use for this property. The precondition to do this, is to link your SKOS concepts to the SKOS concepts of the id.loc.gov vocabulary.".freeze, "Rationale: The repository needs to know the medium on which an object is stored in order to know how and when to do media refreshment and media migration.".freeze],
       domain: "premis:Storage".freeze,
       range: term(
           onProperty: "skos:inScheme".freeze,