Merge pull request #1543 from w3c/issue-1536

Address 1536: extend the range of 'spatial resolution'

dcat/index.html

@@ -2634,10 +2634,15 @@ <h4>Property: spatial resolution</h4>
                 <tr><th class="prop">Usage note:</th><td>If the dataset is an image or grid this should correspond to the spacing of items. For other kinds of spatial datasets, this property will usually indicate the smallest distance between items in the dataset.</td></tr>
                 </table>
 
-            <p>The range of this property is a decimal number representing a length in meters.
+            <p>The range of this property is a number representing a length in meters.
             This is intended to provide a summary indication of the spatial resolution of the data as a single number.
           More complex descriptions of various aspects of spatial precision, accuracy, resolution and other statistics can be provided using the Data Quality Vocabulary [[?VOCAB-DQV]]. </p>
 
+	  <div class="note">
+            <p>As for the use of datatype, note that [[JSON-LD]] converts numbers to <a data-cite="XMLSCHEMA11-2#double"><code>xsd:double</code></a> or <a data-cite="XMLSCHEMA11-2#integer"><code>xsd:integer</code></a>, and properly generating <a data-cite="XMLSCHEMA11-2#decimal"><code>xsd:decimal</code></a> requires the use of strings with an explicit or coerced datatype. In [[Turtle]], seemingly minor modifications can change the datatype of a value: `100.0` is an <a data-cite="XMLSCHEMA11-2#decimal"><code>xsd:decimal</code></a>, while `1e2` is an <a data-cite="XMLSCHEMA11-2#double"><code>xsd:double</code></a>.</p>
+            <p>Note also that number constants without a decimal part (e.g. `42`) will, in [[Turtle]] or [[JSON-LD]], produce a literal with datatype <a data-cite="XMLSCHEMA11-2#integer"><code>xsd:integer</code></a>. Since [[XMLSCHEMA11-2]] defines <a data-cite="XMLSCHEMA11-2#integer"><code>xsd:integer</code></a> as a derived type of <a data-cite="XMLSCHEMA11-2#decimal"><code>xsd:decimal</code></a>, such literals are semantically valid as values of <a href="http://www.w3.org/ns/dcat#spatialResolutionInMeters"><code>dcat:spatialResolutionInMeters</code></a>. However, syntactic validation tools such as [[SHACL]] or [[ShEx]] consider them as distinct datatypes. Authors of validation schemas in these languages should therefore consider adding <a data-cite="XMLSCHEMA11-2#integer"><code>xsd:integer</code></a> to the accepted datatypes for <a href="http://www.w3.org/ns/dcat#spatialResolutionInMeters"><code>dcat:spatialResolutionInMeters</code></a>.</p>
+          </div>
+
         </section>
 
         <section id="Property:dataset_temporal">
@@ -3082,12 +3087,12 @@ <h4>Property: spatial resolution</h4>
             <table class="def">
                 <tr><th>RDF Property:</th><td><a href="http://www.w3.org/ns/dcat#spatialResolutionInMeters"><code>dcat:spatialResolutionInMeters</code></a></td></tr>
                 <tr><th class="prop">Definition:</th><td>The minimum spatial separation resolvable in a dataset distribution, measured in meters.</td></tr>
-                  <tr><th class="prop">Range:</th><td><a href="https://www.w3.org/TR/xmlschema11-2/#decimal"><code>xsd:decimal</code></a></td></tr>
+                  <tr><th class="prop">Range:</th><td><a href="https://www.w3.org/TR/xmlschema11-2/#decimal"><code>xsd:decimal</code></a> or <a data-cite="XMLSCHEMA11-2#double"><code>xsd:double</code></a></td></tr>
                   <tr><th class="prop">Usage note:</th><td>If the dataset is an image or grid this should correspond to the spacing of items. For other kinds of spatial datasets, this property will usually indicate the smallest distance between items in the dataset.</td></tr>
                 <tr><th class="prop">Usage note:</th><td>Alternative spatial resolutions might be provided as different dataset distributions</td></tr>
                 </table>
 
-            <p>The range of this property is a decimal number representing a length in meters.
+            <p>The range of this property is a number representing a length in meters.
             This is intended to provide a summary indication of the spatial resolution of the data distribution as a single number.
           More complex descriptions of various aspects of spatial precision, accuracy, resolution and other statistics can be provided using the Data Quality Vocabulary [[?VOCAB-DQV]]. </p>
 
@@ -6784,6 +6789,7 @@ <h2>Change history</h2>
 
 <p>A full change-log is available on <a href="https://github.com/w3c/dxwg/commits/gh-pages/dcat">GitHub</a></p>
 
+</section>
 
 <section id="changes-since-20220510">
 
@@ -6792,6 +6798,8 @@ <h2>Changes since the fourth public working draft of 10 May 2022</h2>
 <p>The document has undergone the following changes since the DCAT 3 fourth public working draft of 10 May 2022 [[?VOCAB-DCAT-3-20220510]]:</p>
 
 <ul>
+    <li><p>The recommended range of properties <a href="#Property:dataset_spatial_resolution"></a> and <a href="#Property:distribution_spatial_resolution"></a> has been extended to include <a data-cite="XMLSCHEMA11-2#double"><code>xsd:double</code></a> in addition to <a data-cite="XMLSCHEMA11-2#decimal"><code>xsd:decimal</code></a> - see Issue <a href="https://github.com/w3c/dxwg/issues/1536">#1536</a>.</p>
+    </li>
     <li>
 <p>Updated section <a href="#security_and_privacy"></a> to include suggestions about integrity and authenticity  - see Issue <a href="https://github.com/w3c/dxwg/issues/1526 ">#1526</a>.</p>
 </li>