documentation: metanorma/metanorma-model-iso#82

models/ContributorRoleTypes.lutaml

@@ -56,8 +56,8 @@ enum ContributorRoleType {
 
       A large number of visual artists, such as engravers, etchers, and illustrators,
       can be modelled as creators, realisers, or adapters, depending on whether
-      they are creating work they have conceived of themselves (creator),
-      carrying out a creator's artistic vision and following their drafts (realiser),
+      they are creating work they have conceived of themselves (author),
+      carrying out a creator's artistic vision and following their drafts (realizer),
       or copying an artistic work that has already been fully realised in a different
       medium (adapter). In the bibliographic description of visual works,
       realiser is the usual role involved.

models/DocumentIdentifier.lutaml

@@ -29,8 +29,8 @@ class DocumentIdentifier{
   }
   +scope: String[0..1] {
     definition {
-      The scope of the identifier, in case the identifier is not for the document 
-      but for a superset or subset of entities; or in case the identifier 
+      The scope of the identifier, in case the identifier does not apply to the document 
+      but to a superset or subset of entities; or in case the identifier 
       is for a particular instance of the document, e.g. for a particular format or edition of the document.
     }
   }

models/DocumentRelationType.lutaml

@@ -142,7 +142,8 @@ enum DocumentRelationType  {
       The main document is a particular realisation of the intellectual or artistic content of the
       bibliographic item, which is more generically referred to in the target document. 
       This corresponds to _Expression_ in the Functional Requirements for Bibliographic Records (FRBR) model.
-      Inverse of `hasExpression` relation.
+      Inverse of `hasExpression` relation. Includes the more precise `translatedFrom`, `arrangementOf`,
+      `abridgementOf`, and `annotationOf`.
     }
   }
   hasExpression {
@@ -154,7 +155,8 @@ enum DocumentRelationType  {
   }
   translatedFrom {
     definition {
-      The main document is a translation of the target document. Inverse of `hasTranslation` relation.
+      The main document is a translation of the target document. This includes dubbed and subtitled versions of a film.
+      Inverse of `hasTranslation` relation.
     }
   }
   hasTranslation {
@@ -166,9 +168,8 @@ enum DocumentRelationType  {
     definition {
       The main document has the same intellectual or artistic content as the target document, and the main
       document has been created to realise that content through different resources than the target document.
-      Is typically understood 
-      to involve the realisation of a musical work with different instruments than the original. Inverse of
-      `hasArrangement` relation.
+      Is typically understood to involve the realisation of a musical work with different instruments or voices 
+      than the original (arrangement).  This includes adding parts or an accompaniment. Inverse of `hasArrangement` relation.
     }
   }
   hasArrangement {
@@ -182,14 +183,14 @@ enum DocumentRelationType  {
   abridgementOf {
     definition {
       The main document presents a subset of the intellectual or artistic content of the target document,
-      but is still intended as a complete work, presenting a shortened version of the original.
+      but is still intended as a complete work, presenting a shortened version of the main document expression.
       Inverse of `hasAbridgement` relation.
     }
   }
   hasAbridgement {
     definition {
       The main document has a target document which presents a subset of its intellectual or artistic content,
-      but which is still intended as a complete work, presenting a shortened version of the original.
+      but which is still intended as a complete work, presenting a shortened version of the main document expression.
     }
   }
   annotationOf {
@@ -201,7 +202,7 @@ enum DocumentRelationType  {
   hasAnnotation {
     definition {
       The main document has a target document which incorporates part or all of it, and which
-      enhances it with explanatory commentary.
+      enhances it with explanatory commentary ot present in the source expression.
     }
   }
   draftOf {
@@ -249,7 +250,8 @@ enum DocumentRelationType  {
   derivedFrom {
     definition {
       The main document is derived from the target document, depending on it for at least some
-      of its content. Inverse of `derives` relation.
+      of its content. Includes
+      classes not otherwise specified, such as parodies. Inverse of `derives` relation.
     }
   }
   derives {
@@ -288,7 +290,7 @@ enum DocumentRelationType  {
   }
   successorOf {
     definition {
-      The main document has assumed the function of the target dcoument, which has ceased fulfilling
+      The main document has assumed the function of the target document, which has ceased fulfilling
       that function. Typically applies when the target document is a periodical publication 
       which has ceased publication, and the main document is a new periodical publication, 
       designated as the continuation of the target document. 
@@ -297,23 +299,24 @@ enum DocumentRelationType  {
   adaptedFrom {
     definition {
       The main document has its intellectual or artistic content derived from the target document,
-      and has modified it to match the requirements of a different medium. Is typically applied to
-      textual originals, whereas `arrangementOf` is typically applied to musical originals. Inverse of
-      `hasAdaptation` relation.
+      and has modified it to match the requirements of a different medium or audience. 
+      In music, an adaptation changes the musical content, whereas an arrangement
+      changes the instrumenal and vocal resources of the work. Inverse of `hasAdaptation` relation.
     }
   }
   hasAdaptation {
     definition {
       The main document has been modified in the target document, to present its content matching
-      the requirements of a different medium. Is typically applied to
-      textual originals, whereas `hasArrangement` is typically applied to musical originals.
+      the requirements of a different medium or audience. 
     }
   }
   adoptedFrom {
     definition {
-      The main document has its content derived from the target document, and has been adopted in response to it.
-      Typically it is a national standard body's counterpart to an international
-      standard. Inverse of `adoptedAs` relation. Includes more specific relations `identical`, `equivalent`,
+      The main document has its content derived from the target document, and has been adopted in response to it
+      by a distinct authorising body.  Typically it is a national standard body's counterpart to an international
+      standard. (These are potentially the same content, but they have distinct institutional authorship and
+      application; this kind of appropriation of text is not characteristic of literary works.)
+      Inverse of `adoptedAs` relation. Includes more specific relations `identical`, `equivalent`,
       and `nonequivalent`.
     }
   }
@@ -387,7 +390,7 @@ enum DocumentRelationType  {
   }
   complementOf {
     definition {
-      The main document is complementary to the target document, and provides additional
+      The main document is complementary or supplementary to the target document, and provides additional
       or contextual information to help understand the target document. Inverse of `hasComplement` relation.
     }
   }

models/Forename.lutaml

@@ -13,7 +13,7 @@ class Forename{
       Does not include final punctuation, but can include hyphens.
       Can be used instead of forenames,
       if formatted-initials are not provided (in which case each initial will be punctuated
-      following local practice.).
+      following local practice).
     }
   }
 }

models/FullName.lutaml

@@ -23,7 +23,8 @@ class FullName{
   +abbreviation: LocalizedString[0..1] {
     definition {
       The initials of the person, used as an abbreviation for the person, and including the
-      surname. Can be used instead of the complete name.
+      surname. Can be used instead of the complete name. Distinct from formatted-initials,
+      which are the initials only of the forenames of the person.
     }
   }
   +surname: LocalizedString {
@@ -41,7 +42,7 @@ class FullName{
       A preformatted version of the name of the person, not broken down into its component parts.
     }
   }
-  +note: LocalizedString[0..1] {
+  +note: LocalizedString[0..*] {
     definition {
       An additional note about the name of the person.
     }

models/Iso3166Code.lutaml

@@ -1,7 +1,6 @@
 data_type Iso3166Code {
   definition { 
     Code for locale: country or region, as specified in <<iso3166>>.
-    The specification is open as to whether the two-letter code or the three-letter
-    code for countries is used.
+    The two-letter code for countries is used.
   }
 }

models/Iso639Code.lutaml

@@ -1,7 +1,6 @@
 data_type Iso639Code {
   definition { 
     Code for language or language family, as specified in <<iso639>>.
-    The specification is open as to whether the two-letter code or the three-letter
-    code for languages is used.
+    The two-letter code for languages is used where available.
   }
 }

models/KeywordType.lutaml

@@ -12,7 +12,7 @@ class KeywordType {
   }
   +vocab: LocalizedString[0..1] {
     definition {
-      The keyword as an controlled vocabulary term.
+      The keyword as a controlled vocabulary term.
     }
   }
   +taxon: String[0..*] {

models/LocalizedString.lutaml

@@ -1,6 +1,6 @@
 class LocalizedString{
   definition {
-     FormattedString which optionally specifies its language and/or script.
+     FormattedString which optionally specifies its language, locale, and/or script.
   }
   +language: Iso639Code[0..*] {
     definition {