Apply changes suggested by #107

doc/Makefile

@@ -7,7 +7,7 @@ DOCNAME = MANGO
 DOCVERSION = 1.0
 
 # Publication date, ISO format; update manually for "releases"
-DOCDATE = 2026-01-29
+DOCDATE = 2026-02-26
 
 # What is it you're writing: NOTE, WD, PR, REC, PEN, or EN
 DOCTYPE = PR

doc/ivoatexmeta.tex

@@ -1,7 +1,7 @@
 % GENERATED FILE -- edit this in the Makefile
 \newcommand{\ivoaDocversion}{1.0}
-\newcommand{\ivoaDocdate}{2026-01-29}
-\newcommand{\ivoaDocdatecode}{20260129}
+\newcommand{\ivoaDocdate}{2026-02-26}
+\newcommand{\ivoaDocdatecode}{20260226}
 \newcommand{\ivoaDoctype}{PR}
 \newcommand{\ivoaDocname}{MANGO}
 \renewcommand{\ivoaBaseURL}{https://www.ivoa.net/documents/MANGO}

mivot/mango/mango.Brightness.xml

@@ -1,6 +1,6 @@
 <INSTANCE dmrole="" dmtype="mango:Brightness">
    <!-- Observed brightness of the \texttt{MangoObject}.
-The purpose of this property is to gather a brightness value with its error and the its photometric calibration
+The purpose of this property is to gather a brightness value with its error and its photometric calibration
 The distinction between fluxes and magnitudes is made by the unit.
 The photometric calibration is modeled by the \texttt{Phot} data model (1.1)." -->
    <INSTANCE dmrole="mango:Property.semantics" dmtype="mango:VocabularyTerm">

mivot/mango/mango.Color.xml

@@ -1,7 +1,7 @@
 <INSTANCE dmrole="" dmtype="mango:Color">
    <!-- Property that describes a color of the \texttt{MangoObject}.
 The purpose of this property is to gather a color value with its error and the 2 related filters (high and low)
-The color can be given as a magnitude difference or an hardness ratio.
+The color can be given as a magnitude difference or a hardness ratio.
 " -->
    <INSTANCE dmrole="mango:Property.semantics" dmtype="mango:VocabularyTerm">
       <!-- Class holder for a term of a standardized vocabulary that applies to a property." -->
@@ -19,7 +19,7 @@ The color can be given as a magnitude difference or an hardness ratio.
       <!-- Physical color definition giving the way a color is calculated (magnitude difference or hardness ratio)
 and the filters on which the color is based. 
 In case of hardness ratio, the energy bands might be modeled as instances of \texttt{Phot:PhotometryFilter} 
-with a square transfert function." -->
+with a square transfer function." -->
       <!-- Enumeration of the different types of colors supported by the model. -->
       <!-- Enumeration datatype: supported values are ColorIndex HardnessRatio  -->
       <ATTRIBUTE dmrole="mango:ColorDef.definition" dmtype="mango:ColorDefinition" value="OneOf ColorIndex HardnessRatio "/>

mivot/mango/mango.ColorDef.xml

@@ -2,7 +2,7 @@
    <!-- Physical color definition giving the way a color is calculated (magnitude difference or hardness ratio)
 and the filters on which the color is based. 
 In case of hardness ratio, the energy bands might be modeled as instances of \texttt{Phot:PhotometryFilter} 
-with a square transfert function." -->
+with a square transfer function." -->
    <!-- Enumeration of the different types of colors supported by the model. -->
    <!-- Enumeration datatype: supported values are ColorIndex HardnessRatio  -->
    <ATTRIBUTE dmrole="mango:ColorDef.definition" dmtype="mango:ColorDefinition" value="OneOf ColorIndex HardnessRatio "/>

mivot/mango/mango.EpochPosition.xml

@@ -5,7 +5,7 @@
  It consists of a celestial position, a proper motion, a radial velocity and a parallax and their associated 
  errors encapsulated into the \texttt{EpochPositionErrors} class. 
  The values of these properties are pulled from the underlying Astronomical Coordinates and Coordinate Systems 
- model \citep{2022ivoa.spec.1004R}
+ model \citep{2022ivoa.spec.1004R}.
 
 At a high level the properties map as follows:
 \begin{itemize}
@@ -20,7 +20,7 @@ All components use the same coordinate systems for both time and space coordinat
 
 \begin{itemize}
    \item Both position and proper motion reuse \texttt{coords:LonLatPoint} elements.
-   \item The space coordinate system is imported from \texttt{coordsSpaceSys}.
+   \item The space coordinate system is imported from \texttt{coords:SpaceSys}.
    \item The time coordinate system is imported from \texttt{coords:TimeSys}.
 \end{itemize}
 

mivot/mango/mango.Status.xml

@@ -17,7 +17,7 @@ that can only take on a defined number of values, each with its own description.
 " -->
       <COLLECTION dmrole="mango:StatusValues.values">
          <INSTANCE dmrole="" dmtype="mango:StatusValue">
-            <!-- Value allowed for a status; contain the value with a free text description." -->
+            <!-- Value allowed for a status; contains the value with a free text description." -->
             <ATTRIBUTE dmrole="mango:StatusValue.value" dmtype="ivoa:string" ref="@@@@@" value=""/>
             <ATTRIBUTE dmrole="mango:StatusValue.description" dmtype="ivoa:string" ref="@@@@@" value=""/>
          </INSTANCE>

mivot/mango/mango.StatusValue.xml

@@ -1,5 +1,5 @@
 <INSTANCE dmrole="" dmtype="mango:StatusValue">
-   <!-- Value allowed for a status; contain the value with a free text description." -->
+   <!-- Value allowed for a status; contains the value with a free text description." -->
    <ATTRIBUTE dmrole="mango:StatusValue.value" dmtype="ivoa:string" ref="@@@@@" value=""/>
    <ATTRIBUTE dmrole="mango:StatusValue.description" dmtype="ivoa:string" ref="@@@@@" value=""/>
 </INSTANCE>

mivot/mango/mango.StatusValues.xml

@@ -3,7 +3,7 @@
 " -->
    <COLLECTION dmrole="mango:StatusValues.values">
       <INSTANCE dmrole="" dmtype="mango:StatusValue">
-         <!-- Value allowed for a status; contain the value with a free text description." -->
+         <!-- Value allowed for a status; contains the value with a free text description." -->
          <ATTRIBUTE dmrole="mango:StatusValue.value" dmtype="ivoa:string" ref="@@@@@" value=""/>
          <ATTRIBUTE dmrole="mango:StatusValue.description" dmtype="ivoa:string" ref="@@@@@" value=""/>
       </INSTANCE>

utils/processVodml.py

@@ -21,7 +21,7 @@
 image = r"""\1 \2 }
   \\begin{figure}[h]
     \\includegraphics[width=1.0\\textwidth]{../model/\2.png}
-    \\caption{package \2}
+    \\caption{\2 package}
     \\label{fig:\2}
   \\end{figure}\n
 """

vo-dml/desc.mango.vo-dml.xml

@@ -123,7 +123,7 @@ Using the polygon serialization requires the space coordinate system to be defin
     <attribute>
       <vodml-id>VocabularyTerm.uri</vodml-id>
       <name>uri</name>
-      <description>URI the vocabulary term</description>
+      <description>URI of the vocabulary term</description>
       <datatype>
         <vodml-ref>ivoa:string</vodml-ref>
       </datatype>
@@ -137,7 +137,7 @@ Using the polygon serialization requires the space coordinate system to be defin
       <name>label</name>
       <description>Label attached to the vocabulary term.
 This is necessary because the URI may not contain any explicit label.
-This was the case for the IUA vocabulary until the Registry WG introduced 
+This was the case for the UAT vocabulary until the Registry WG introduced 
 rewriting rules that fix the issue.</description>
       <datatype>
         <vodml-ref>ivoa:string</vodml-ref>
@@ -579,7 +579,7 @@ in \url{http://www.ivoa.net/rdf/processing-level}</description>
     <name>Color</name>
     <description>Property that describes a color of the \texttt{MangoObject}.
 The purpose of this property is to gather a color value with its error and the 2 related filters (high and low)
-The color can be given as a magnitude difference or an hardness ratio.
+The color can be given as a magnitude difference or a hardness ratio.
 </description>
     <extends>
       <vodml-ref>mango:Property</vodml-ref>
@@ -630,7 +630,7 @@ The color can be given as a magnitude difference or an hardness ratio.
     <description>Physical color definition giving the way a color is calculated (magnitude difference or hardness ratio)
 and the filters on which the color is based. 
 In case of hardness ratio, the energy bands might be modeled as instances of \texttt{Phot:PhotometryFilter} 
-with a square transfert function.</description>
+with a square transfer function.</description>
     <attribute>
       <vodml-id>ColorDef.definition</vodml-id>
       <name>definition</name>
@@ -646,7 +646,8 @@ with a square transfert function.</description>
     <reference>
       <vodml-id>ColorDef.high</vodml-id>
       <name>high</name>
-      <description>Reference to the \texttt{Phot:PhotometryFilter} \citep{2022ivoa.spec.1101S} corresponding the higher band of the color.
+      <description>Reference to the \texttt{Phot:PhotometryFilter} \citep{2022ivoa.spec.1101S} corresponding 
+to the higher band of the color.
 </description>
       <datatype>
         <vodml-ref>Phot:PhotometryFilter</vodml-ref>
@@ -659,7 +660,7 @@ with a square transfert function.</description>
     <reference>
       <vodml-id>ColorDef.low</vodml-id>
       <name>low</name>
-      <description>Reference to the \texttt{Phot:PhotometryFilter} corresponding the lower band for that color.
+      <description>Reference to the \texttt{Phot:PhotometryFilter} corresponding to the lower band for that color.
 </description>
       <datatype>
         <vodml-ref>Phot:PhotometryFilter</vodml-ref>
@@ -693,7 +694,7 @@ with a square transfert function.</description>
   <objectType>
     <vodml-id>StatusValue</vodml-id>
     <name>StatusValue</name>
-    <description>Value allowed for a status; contain the value with a free text description.</description>
+    <description>Value allowed for a status; contains the value with a free text description.</description>
     <attribute>
       <vodml-id>StatusValue.value</vodml-id>
       <name>value</name>
@@ -729,7 +730,7 @@ with a square transfert function.</description>
  It consists of a celestial position, a proper motion, a radial velocity and a parallax and their associated 
  errors encapsulated into the \texttt{EpochPositionErrors} class. 
  The values of these properties are pulled from the underlying Astronomical Coordinates and Coordinate Systems 
- model \citep{2022ivoa.spec.1004R}
+ model \citep{2022ivoa.spec.1004R}.
 
 At a high level the properties map as follows:
 \begin{itemize}
@@ -931,7 +932,7 @@ providers to convey whether or not the factor has been applied (see \texttt{meas
     <reference>
       <vodml-id>EpochPosition.spaceSys</vodml-id>
       <name>spaceSys</name>
-      <description>System that applies the space coordinates.</description>
+      <description>System that applies to the space coordinates.</description>
       <datatype>
         <vodml-ref>coords:SpaceSys</vodml-ref>
       </datatype>
@@ -943,7 +944,7 @@ providers to convey whether or not the factor has been applied (see \texttt{meas
     <reference>
       <vodml-id>EpochPosition.timeSys</vodml-id>
       <name>timeSys</name>
-      <description>System that applies the time coordinates (the epoch).</description>
+      <description>System that applies to the time coordinates (the epoch).</description>
       <datatype>
         <vodml-ref>coords:TimeSys</vodml-ref>
       </datatype>
@@ -1150,7 +1151,7 @@ providers to convey whether or not the factor has been applied (see \texttt{meas
     <vodml-id>Brightness</vodml-id>
     <name>Brightness</name>
     <description>Observed brightness of the \texttt{MangoObject}.
-The purpose of this property is to gather a brightness value with its error and the its photometric calibration
+The purpose of this property is to gather a brightness value with its error and its photometric calibration
 The distinction between fluxes and magnitudes is made by the unit.
 The photometric calibration is modeled by the \texttt{Phot} data model (1.1).</description>
     <extends>
@@ -1203,7 +1204,7 @@ It must be an instance of \texttt{photdm:PhotCal}.</description>
     <description>The \texttt{error} package (fig \ref{fig:error}) groups the MANGO built-in error classes. 
 All these classes are derived from \texttt{meas:Uncertainty} to make
 them reusable by \texttt{meas:Measure} instances. Mango errors all 
-have an attribute that specifies the confidence level</description>
+have an attribute that specifies the confidence level.</description>
     <dataType abstract="true">
       <vodml-id>error.PropertyError</vodml-id>
       <name>PropertyError</name>
@@ -1227,7 +1228,7 @@ The confidence level must be in $[0, 1]$ (not enforced by the VO-DML schema).</d
         <vodml-id>error.PropertyError.distribution</vodml-id>
         <name>distribution</name>
         <description>Statistical distribution of the error. 
-The Value can a vocabulary URI (e.g. \url{https://www.ivoa.net/rdf/uat/2024-06-25/uat.html#poisson-distribution}).</description>
+The Value can be a vocabulary URI (e.g. \url{https://www.ivoa.net/rdf/uat/2024-06-25/uat.html#poisson-distribution}).</description>
         <datatype>
           <vodml-ref>ivoa:string</vodml-ref>
         </datatype>
@@ -1295,7 +1296,7 @@ This is not enforced by the model. The definition of the ellipse attribute is im
       <attribute>
         <vodml-id>error.PErrorEllipse.angle</vodml-id>
         <name>angle</name>
-        <description>In theory, this is the angle between the North Polar Cape (NPC) and the major axis. 
+        <description>In theory, this is the angle between the North Celestial Pole (NCP) and the major axis. 
 This angle must be positive taking into account that angles are positive from North to the East. 
 The angle has its own unit.
 In practice, the angle definition is this used by the mapped data set. 
@@ -1386,7 +1387,7 @@ It is usually the angle between the major axis and the north axis (negative alon
     <name>origin</name>
     <description>Package grouping together all the components needed to model the origin of the \texttt{MangoObject} (fig \ref{fig:origin}).
 The design of the package complies with the work of the DCP interest 
-group (see \url{https://ivoa.net/documents/DataOrigin/index.html})</description>
+group (see \url{https://ivoa.net/documents/DataOrigin/index.html}).</description>
     <objectType>
       <vodml-id>origin.Article</vodml-id>
       <name>Article</name>
@@ -1461,7 +1462,7 @@ group (see \url{https://ivoa.net/documents/DataOrigin/index.html})</description>
       <attribute>
         <vodml-id>origin.DataOrigin.creators</vodml-id>
         <name>creators</name>
-        <description>Person(s) mainly involved in the creation of the resource, generally the author</description>
+        <description>Person(s) mainly involved in the creation of the resource, generally the author(s).</description>
         <datatype>
           <vodml-ref>ivoa:string</vodml-ref>
         </datatype>
@@ -1523,7 +1524,7 @@ group (see \url{https://ivoa.net/documents/DataOrigin/index.html})</description>
         <vodml-id>origin.DataOrigin.rights_uri</vodml-id>
         <name>rights_uri</name>
         <description>Licence URI. Following Registry practice, this should come from SPDX (\url{https://spdx.org/licenses}),
-though Creative Commons URLs (\url{https://creativecommons.org are also admitted}).</description>
+though Creative Commons URLs (\url{https://creativecommons.org}) are also admitted.</description>
         <datatype>
           <vodml-ref>ivoa:string</vodml-ref>
         </datatype>
@@ -1592,7 +1593,8 @@ though Creative Commons URLs (\url{https://creativecommons.org are also admitted
         <name>request</name>
         <description>Full request URL including a query string. 
 For the simple protocols,put the url-encoded form of the query parameters. 
-For TAP queries, use the /sync UWS \citep{2016ivoa.spec.1024H} URL. The format is free for others request types.</description>
+For TAP queries, use the /sync UWS \citep{2016ivoa.spec.1024H} URL.
+The format is free for other request types.</description>
         <datatype>
           <vodml-ref>ivoa:string</vodml-ref>
         </datatype>

vo-dml/desc/desc.Brightness.txt

@@ -1,4 +1,4 @@
 Observed brightness of the \texttt{MangoObject}.
-The purpose of this property is to gather a brightness value with its error and the its photometric calibration
+The purpose of this property is to gather a brightness value with its error and its photometric calibration
 The distinction between fluxes and magnitudes is made by the unit.
 The photometric calibration is modeled by the \texttt{Phot} data model (1.1).

vo-dml/desc/desc.Color.txt

@@ -1,3 +1,3 @@
 Property that describes a color of the \texttt{MangoObject}.
 The purpose of this property is to gather a color value with its error and the 2 related filters (high and low)
-The color can be given as a magnitude difference or an hardness ratio.
+The color can be given as a magnitude difference or a hardness ratio.

vo-dml/desc/desc.ColorDef.high.txt

@@ -1 +1,2 @@
-Reference to the \texttt{Phot:PhotometryFilter} \citep{2022ivoa.spec.1101S} corresponding the higher band of the color.
+Reference to the \texttt{Phot:PhotometryFilter} \citep{2022ivoa.spec.1101S} corresponding 
+to the higher band of the color.

vo-dml/desc/desc.ColorDef.low.txt

@@ -1 +1 @@
-Reference to the \texttt{Phot:PhotometryFilter} corresponding the lower band for that color.
+Reference to the \texttt{Phot:PhotometryFilter} corresponding to the lower band for that color.

vo-dml/desc/desc.ColorDef.txt

@@ -1,4 +1,4 @@
 Physical color definition giving the way a color is calculated (magnitude difference or hardness ratio)
 and the filters on which the color is based. 
 In case of hardness ratio, the energy bands might be modeled as instances of \texttt{Phot:PhotometryFilter} 
-with a square transfert function.
+with a square transfer function.

vo-dml/desc/desc.EpochPosition.spaceSys.txt

@@ -1 +1 @@
-System that applies the space coordinates.
+System that applies to the space coordinates.

vo-dml/desc/desc.EpochPosition.timeSys.txt

@@ -1 +1 @@
-System that applies the time coordinates (the epoch).
+System that applies to the time coordinates (the epoch).

vo-dml/desc/desc.EpochPosition.txt

@@ -4,7 +4,7 @@
  It consists of a celestial position, a proper motion, a radial velocity and a parallax and their associated 
  errors encapsulated into the \texttt{EpochPositionErrors} class. 
  The values of these properties are pulled from the underlying Astronomical Coordinates and Coordinate Systems 
- model \citep{2022ivoa.spec.1004R}
+ model \citep{2022ivoa.spec.1004R}.
 
 At a high level the properties map as follows:
 \begin{itemize}

vo-dml/desc/desc.StatusValue.txt

@@ -1 +1 @@
-Value allowed for a status; contain the value with a free text description.
+Value allowed for a status; contains the value with a free text description.

vo-dml/desc/desc.VocabularyTerm.label.txt

@@ -1,4 +1,4 @@
 Label attached to the vocabulary term.
 This is necessary because the URI may not contain any explicit label.
-This was the case for the IUA vocabulary until the Registry WG introduced 
+This was the case for the UAT vocabulary until the Registry WG introduced 
 rewriting rules that fix the issue.

vo-dml/desc/desc.VocabularyTerm.uri.txt

@@ -1 +1 @@
-URI the vocabulary term
+URI of the vocabulary term

vo-dml/desc/desc.error.PErrorEllipse.angle.txt

@@ -1,4 +1,4 @@
-In theory, this is the angle between the North Polar Cape (NPC) and the major axis. 
+In theory, this is the angle between the North Celestial Pole (NCP) and the major axis. 
 This angle must be positive taking into account that angles are positive from North to the East. 
 The angle has its own unit.
 In practice, the angle definition is this used by the mapped data set. 

vo-dml/desc/desc.error.PropertyError.distribution.txt

@@ -1,2 +1,2 @@
 Statistical distribution of the error. 
-The Value can a vocabulary URI (e.g. \url{https://www.ivoa.net/rdf/uat/2024-06-25/uat.html#poisson-distribution}).
+The Value can be a vocabulary URI (e.g. \url{https://www.ivoa.net/rdf/uat/2024-06-25/uat.html#poisson-distribution}).

vo-dml/desc/desc.error.txt

@@ -1,4 +1,4 @@
 The \texttt{error} package (fig \ref{fig:error}) groups the MANGO built-in error classes. 
 All these classes are derived from \texttt{meas:Uncertainty} to make
 them reusable by \texttt{meas:Measure} instances. Mango errors all 
-have an attribute that specifies the confidence level
+have an attribute that specifies the confidence level.

vo-dml/desc/desc.origin.DataOrigin.creators.txt

@@ -1 +1 @@
-Person(s) mainly involved in the creation of the resource, generally the author
+Person(s) mainly involved in the creation of the resource, generally the author(s).

vo-dml/desc/desc.origin.DataOrigin.rights_uri.txt

@@ -1,2 +1,2 @@
 Licence URI. Following Registry practice, this should come from SPDX (\url{https://spdx.org/licenses}),
-though Creative Commons URLs (\url{https://creativecommons.org are also admitted}).
+though Creative Commons URLs (\url{https://creativecommons.org}) are also admitted.