rdf-tabular 1.0.0 → 3.1.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
-SHA1:
-  metadata.gz: 5fd3ba26034d83ae78387e86545e7020a2299141
-  data.tar.gz: 79494794a8a96f1799c0ecf7e28891f230a97f70
+SHA256:
+  metadata.gz: 8f68919eede6ef37e82c02137ca4fed754cfb5ff8783d224ffb2667e83f27b24
+  data.tar.gz: 68f52f1bba580653f7173eef677bdcadbd62293892b100b62d85c9c39f349202
 SHA512:
-  metadata.gz: def477f7bc65c716906f2e5bf75afde8e79a8abb5304cffc4cb5624f9dc412ae936a5ef4308e3555c865e1b0562d7b398b4706927df632ef47f1b706ea8fc66b
-  data.tar.gz: c61c6772c207e44062e6a92726e64e07a28ab18149f18b564403fd15e6f85badb96f0eb5e39fe253547f9c6837c4538b9a5db52881011d521f51217a2682bcf6
+  metadata.gz: 3c3351072c7cef3f82cf5e4bb160defd7dc5a1d3a39cf4094543a48de9c8e81bcb47fb448d901dd14423062765bf17c283377fbdbf9f57f03f508d5b8f3d00e4
+  data.tar.gz: 47eb938e6067ed620e9fab129a45eae3f89fc01a53044aa4a72d0ef4100f9e0e6a36a80a98d3800f10a458f953877cdc6d3e1a8eb4295130d5534864d5697fee

data/README.md

@@ -2,17 +2,16 @@
 
 [CSV][] reader for [RDF.rb][] and fully JSON serializer.
 
-[![Gem Version](https://badge.fury.io/rb/rdf-tabular.png)](http://badge.fury.io/rb/rdf-tabular)
-[![Build Status](https://secure.travis-ci.org/ruby-rdf/rdf-tabular.png?branch=master)](http://travis-ci.org/ruby-rdf/rdf-tabular)
+[![Gem Version](https://badge.fury.io/rb/rdf-tabular.png)](https://badge.fury.io/rb/rdf-tabular)
+[![Build Status](https://secure.travis-ci.org/ruby-rdf/rdf-tabular.png?branch=master)](https://travis-ci.org/ruby-rdf/rdf-tabular)
 [![Coverage Status](https://coveralls.io/repos/ruby-rdf/rdf-tabular/badge.svg)](https://coveralls.io/r/ruby-rdf/rdf-tabular)
-[![Dependency Status](https://gemnasium.com/ruby-rdf/rdf-tabular.png)](https://gemnasium.com/ruby-rdf/rdf-tabular)
 
 ## Features
 
 RDF::Tabular parses CSV or other Tabular Data into [RDF][] and JSON using the [W3C CSVW][] specifications, currently undergoing development.
 
-* Parses [number patterns](http://www.unicode.org/reports/tr35/tr35-39/tr35-numbers.html#Number_Patterns) from [UAX35][]
-* Parses [date formats](http://www.unicode.org/reports/tr35/tr35-39/tr35-dates.html#Contents) from [UAX35][]
+* Parses [number patterns](https://www.unicode.org/reports/tr35/tr35-39/tr35-numbers.html#Number_Patterns) from [UAX35][]
+* Parses [date formats](https://www.unicode.org/reports/tr35/tr35-39/tr35-dates.html#Contents) from [UAX35][]
 * Returns detailed errors and warnings using optional `Logger`.
 
 ## Installation
@@ -31,7 +30,7 @@ Metadata can then provide datatypes for the columns, express foreign key relatio
       "@context": "http://www.w3.org/ns/csvw",
       "url": "doap.csv",
       "tableSchema": {
-        "aboutUrl": "http://rubygems.org/gems/rdf-tabular",
+        "aboutUrl": "https://rubygems.org/gems/rdf-tabular",
         "propertyUrl": "http://usefulinc.com/ns/doap#{_name}",
         "null": "",
         "columns": [
@@ -74,29 +73,29 @@ This results in the following Turtle:
     @prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
     @prefix xsd: <http://www.w3.org/2001/XMLSchema#> .
 
-    <http://rubygems.org/gems/rdf-tabular> a doap:Project,
+    <https://rubygems.org/gems/rdf-tabular> a doap:Project,
          <http://www.w3.org/ns/earl#TestSubject>,
          <http://www.w3.org/ns/earl#Software>;
        dc:title "RDF::Tabular";
        dc:creator <http://greggkellogg.net/foaf#me>;
        dc:date "2015-01-05"^^xsd:date;
        dc:description "RDF::Tabular processes tabular data with metadata creating RDF or JSON output."@en;
-       dc:isPartOf <http://rubygems.org/gems/rdf>;
+       dc:isPartOf <https://rubygems.org/gems/rdf>;
        doap:blog <http://greggkellogg.net/>;
-       doap:bug-database <http://github.com/ruby-rdf/rdf-tabular/issues>;
+       doap:bug-database <https://github.com/ruby-rdf/rdf-tabular/issues>;
        doap:category <http://dbpedia.org/resource/Resource_Description_Framework>,
          <http://dbpedia.org/resource/Ruby_(programming_language)>;
        doap:created "2015-01-05"^^xsd:date;
        doap:description "RDF::Tabular processes tabular data with metadata creating RDF or JSON output."@en;
        doap:developer <http://greggkellogg.net/foaf#me>;
        doap:documenter <http://greggkellogg.net/foaf#me>;
-       doap:download-page <http://rubygems.org/gems/rdf-tabular>;
+       doap:download-page <https://rubygems.org/gems/rdf-tabular>;
        doap:homepage <http://ruby-rdf.github.com/rdf-tabular>;
        doap:implements <http://www.w3.org/TR/tabular-data-model/>,
          <http://www.w3.org/TR/tabular-metadata/>,
          <http://www.w3.org/TR/csv2rdf/>,
          <http://www.w3.org/TR/csv2json/>;
-       doap:license <http://creativecommons.org/licenses/publicdomain/>;
+       doap:license <https://unlicense.org/1.0/>;
        doap:mailing-list <http://lists.w3.org/Archives/Public/public-rdf-ruby/>;
        doap:maintainer <http://greggkellogg.net/foaf#me>;
        doap:name "RDF::Tabular";
@@ -110,22 +109,22 @@ This results in the following Turtle:
           a csvw:Table;
           csvw:row [
             a csvw:Row;
-            csvw:describes <http://rubygems.org/gems/rdf-tabular>;
+            csvw:describes <https://rubygems.org/gems/rdf-tabular>;
             csvw:rownum 1;
             csvw:url <file://users/gregg/Projects/rdf-tabular/etc/doap.csv#row=2>
           ],  [
             a csvw:Row;
-            csvw:describes <http://rubygems.org/gems/rdf-tabular>;
+            csvw:describes <https://rubygems.org/gems/rdf-tabular>;
             csvw:rownum 2;
             csvw:url <file://users/gregg/Projects/rdf-tabular/etc/doap.csv#row=3>
           ],  [
             a csvw:Row;
-            csvw:describes <http://rubygems.org/gems/rdf-tabular>;
+            csvw:describes <https://rubygems.org/gems/rdf-tabular>;
             csvw:rownum 3;
             csvw:url <file://users/gregg/Projects/rdf-tabular/etc/doap.csv#row=4>
           ],  [
             a csvw:Row;
-            csvw:describes <http://rubygems.org/gems/rdf-tabular>;
+            csvw:describes <https://rubygems.org/gems/rdf-tabular>;
             csvw:rownum 4;
             csvw:url <file://users/gregg/Projects/rdf-tabular/etc/doap.csv#row=5>
           ];
@@ -144,7 +143,7 @@ This results in the following Turtle:
             prov:hadRole csvw:tabularMetadata
           ];
           prov:startedAtTime "2015-04-11T12:33:25Z"^^xsd:dateTime;
-          prov:wasAssociatedWith <http://rubygems.org/gems/rdf-tabular>
+          prov:wasAssociatedWith <https://rubygems.org/gems/rdf-tabular>
         ]
      ] .
 
@@ -162,20 +161,20 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
               "rownum": 1,
               "describes": [
                 {
-                  "@id": "http://rubygems.org/gems/rdf-tabular",
+                  "@id": "https://rubygems.org/gems/rdf-tabular",
                   "http://usefulinc.com/ns/doap#name": "RDF::Tabular",
                   "@type": "http://usefulinc.com/ns/doap#Project",
                   "http://usefulinc.com/ns/doap#homepage": "http://ruby-rdf.github.com/rdf-tabular",
-                  "http://usefulinc.com/ns/doap#license": "http://creativecommons.org/licenses/publicdomain/",
+                  "http://usefulinc.com/ns/doap#license": "https://unlicense.org/1.0/",
                   "http://usefulinc.com/ns/doap#shortdesc": "Tabular Data RDF Reader and JSON serializer.",
                   "http://usefulinc.com/ns/doap#description": "RDF::Tabular processes tabular data with metadata creating RDF or JSON output.",
                   "http://usefulinc.com/ns/doap#created": "2015-01-05",
                   "http://usefulinc.com/ns/doap#programming-language": "Ruby",
                   "http://usefulinc.com/ns/doap#implements": "http://www.w3.org/TR/tabular-data-model/",
                   "http://usefulinc.com/ns/doap#category": "http://dbpedia.org/resource/Resource_Description_Framework",
-                  "http://usefulinc.com/ns/doap#download-page": "http://rubygems.org/gems/rdf-tabular",
+                  "http://usefulinc.com/ns/doap#download-page": "https://rubygems.org/gems/rdf-tabular",
                   "http://usefulinc.com/ns/doap#mailing-list": "http://lists.w3.org/Archives/Public/public-rdf-ruby/",
-                  "http://usefulinc.com/ns/doap#bug-database": "http://github.com/ruby-rdf/rdf-tabular/issues",
+                  "http://usefulinc.com/ns/doap#bug-database": "https://github.com/ruby-rdf/rdf-tabular/issues",
                   "http://usefulinc.com/ns/doap#blog": "http://greggkellogg.net/",
                   "http://usefulinc.com/ns/doap#developer": "http://greggkellogg.net/foaf#me",
                   "http://usefulinc.com/ns/doap#maintainer": "http://greggkellogg.net/foaf#me",
@@ -185,7 +184,7 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
                   "dc:description": "RDF::Tabular processes tabular data with metadata creating RDF or JSON output.",
                   "dc:date": "2015-01-05",
                   "dc:creator": "http://greggkellogg.net/foaf#me",
-                  "dc:isPartOf": "http://rubygems.org/gems/rdf"
+                  "dc:isPartOf": "https://rubygems.org/gems/rdf"
                 }
               ]
             },
@@ -194,7 +193,7 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
               "rownum": 2,
               "describes": [
                 {
-                  "@id": "http://rubygems.org/gems/rdf-tabular",
+                  "@id": "https://rubygems.org/gems/rdf-tabular",
                   "@type": "http://www.w3.org/ns/earl#TestSubject",
                   "http://usefulinc.com/ns/doap#implements": "http://www.w3.org/TR/tabular-metadata/",
                   "http://usefulinc.com/ns/doap#category": "http://dbpedia.org/resource/Ruby_(programming_language)"
@@ -206,7 +205,7 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
               "rownum": 3,
               "describes": [
                 {
-                  "@id": "http://rubygems.org/gems/rdf-tabular",
+                  "@id": "https://rubygems.org/gems/rdf-tabular",
                   "@type": "http://www.w3.org/ns/earl#Software",
                   "http://usefulinc.com/ns/doap#implements": "http://www.w3.org/TR/csv2rdf/"
                 }
@@ -217,7 +216,7 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
               "rownum": 4,
               "describes": [
                 {
-                  "@id": "http://rubygems.org/gems/rdf-tabular",
+                  "@id": "https://rubygems.org/gems/rdf-tabular",
                   "http://usefulinc.com/ns/doap#implements": "http://www.w3.org/TR/csv2json/"
                 }
               ]
@@ -229,8 +228,27 @@ It can also generate JSON output (not complete JSON-LD, but compatible with it),
 
 ## Tutorials
 
-* [CSV on the Web](http://greggkellogg.net/CSV-on-the-Web)
-* [Implementing CSV on the Web](http://greggkellogg.net/2015/04/implementing-csv-on-the-web/)
+* [CSV on the Web](https://www.greggkellogg.net/2015/08/csv-on-the-web-presentation/)
+* [Implementing CSV on the Web](https://greggkellogg.net/2015/04/implementing-csv-on-the-web/)
+
+## Command Line
+When the `linkeddata` gem is installed, RDF.rb includes a `rdf` executable which acts as a wrapper to perform a number of different
+operations on RDF files using available readers and writers, including RDF::Tabular. The commands specific to RDF::Tabular is 
+
+* `tabular-json`: Parse the CSV file and emit data as Tabular JSON
+
+To use RDF::Tabular specific features, you must use the `--input-format tabular` option to the `rdf` executable.
+
+Other `rdf` commands and options treat CSV as a standard RDF format.
+
+Example usage:
+
+    rdf serialize https://raw.githubusercontent.com/ruby-rdf/rdf-tabular/develop/etc/doap.csv \
+      --output-format ttl
+    rdf tabular-json --input-format tabular https://raw.githubusercontent.com/ruby-rdf/rdf-tabular/develop/etc/doap.csv
+    rdf validate https://raw.githubusercontent.com/ruby-rdf/rdf-tabular/develop/etc/doap.csv --validate
+
+Note that the `--validate` option must be used with the `validate` (or other) command to detect parse-time errors in addition to validating any resulting RDF triples.
 
 ## RDF Reader
 RDF::Tabular also acts as a normal RDF reader, using the standard RDF.rb Reader interface:
@@ -238,7 +256,7 @@ RDF::Tabular also acts as a normal RDF reader, using the standard RDF.rb Reader
     graph = RDF::Graph.load("etc/doap.csv", minimal: true)
 
 ## Documentation
-Full documentation available on [RubyDoc](http://rubydoc.info/gems/rdf-tabular/file/README.md)
+Full documentation available on [RubyDoc](https://rubydoc.info/gems/rdf-tabular/file/README.md)
 
 ### Principal Classes
 * {RDF::Tabular}
@@ -248,21 +266,21 @@ Full documentation available on [RubyDoc](http://rubydoc.info/gems/rdf-tabular/f
   * {RDF::Tabular::Reader}
 
 ## Dependencies
-* [Ruby](http://ruby-lang.org/) (>= 2.2.2)
-* [RDF.rb](http://rubygems.org/gems/rdf) (>= 2.0)
-* [JSON](https://rubygems.org/gems/json) (>= 1.5)
+* [Ruby](https://ruby-lang.org/) (>= 2.2.2)
+* [RDF.rb](https://rubygems.org/gems/rdf) (~> 3.0)
+* [JSON](https://rubygems.org/gems/json) (>= 2.0)
 
 ## Installation
-The recommended installation method is via [RubyGems](http://rubygems.org/).
+The recommended installation method is via [RubyGems](https://rubygems.org/).
 To install the latest official release of the `RDF::Tabular` gem, do:
 
     % [sudo] gem install rdf-tabular
 
 ## Mailing List
-* <http://lists.w3.org/Archives/Public/public-rdf-ruby/>
+* <https://lists.w3.org/Archives/Public/public-rdf-ruby/>
 
 ## Author
-* [Gregg Kellogg](http://github.com/gkellogg) - <http://greggkellogg.net/>
+* [Gregg Kellogg](https://github.com/gkellogg) - <https://greggkellogg.net/>
 
 ## Contributing
 * Do your best to adhere to the existing coding conventions and idioms.
@@ -277,15 +295,15 @@ License
 -------
 
 This is free and unencumbered public domain software. For more information,
-see <http://unlicense.org/> or the accompanying {file:UNLICENSE} file.
-
-[Ruby]:             http://ruby-lang.org/
-[RDF]:              http://www.w3.org/RDF/
-[YARD]:             http://yardoc.org/
-[YARD-GS]:          http://rubydoc.info/docs/yard/file/docs/GettingStarted.md
-[PDD]:              http://lists.w3.org/Archives/Public/public-rdf-ruby/2010May/0013.html
-[RDF.rb]:           http://rubygems.org/gems/rdf
-[CSV]:              http://en.wikipedia.org/wiki/Comma-separated_values
-[W3C CSVW]:         http://www.w3.org/2013/csvw/wiki/Main_Page
+see <https://unlicense.org/> or the accompanying {file:UNLICENSE} file.
+
+[Ruby]:             https://ruby-lang.org/
+[RDF]:              https://www.w3.org/RDF/
+[YARD]:             https://yardoc.org/
+[YARD-GS]:          https://rubydoc.info/docs/yard/file/docs/GettingStarted.md
+[PDD]:              https://lists.w3.org/Archives/Public/public-rdf-ruby/2010May/0013.html
+[RDF.rb]:           https://rubygems.org/gems/rdf
+[CSV]:              https://en.wikipedia.org/wiki/Comma-separated_values
+[W3C CSVW]:         https://www.w3.org/2013/csvw/wiki/Main_Page
 [URI template]:     https://tools.ietf.org/html/rfc6570
-[UAX35]:            http://www.unicode.org/reports/tr15/
+[UAX35]:            https://www.unicode.org/reports/tr15/

data/UNLICENSE

@@ -21,4 +21,4 @@ OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 OTHER DEALINGS IN THE SOFTWARE.
 
-For more information, please refer to <http://unlicense.org/>
+For more information, please refer to <https://unlicense.org/>

data/VERSION

@@ -1 +1 @@
-1.0.0
+3.1.1

data/etc/csvw.jsonld

@@ -1,5 +1,6 @@
 {
   "@context": {
+    "as": "https://www.w3.org/ns/activitystreams#",
     "cc": "http://creativecommons.org/ns#",
     "csvw": "http://www.w3.org/ns/csvw#",
     "ctag": "http://commontag.org/ns#",
@@ -8,10 +9,13 @@
     "dcat": "http://www.w3.org/ns/dcat#",
     "dcterms": "http://purl.org/dc/terms/",
     "dctypes": "http://purl.org/dc/dcmitype/",
+    "dqv": "http://www.w3.org/ns/dqv#",
+    "duv": "https://www.w3.org/TR/vocab-duv#",
     "foaf": "http://xmlns.com/foaf/0.1/",
     "gr": "http://purl.org/goodrelations/v1#",
     "grddl": "http://www.w3.org/2003/g/data-view#",
     "ical": "http://www.w3.org/2002/12/cal/icaltzd#",
+    "ldp": "http://www.w3.org/ns/ldp#",
     "ma": "http://www.w3.org/ns/ma-ont#",
     "oa": "http://www.w3.org/ns/oa#",
     "og": "http://ogp.me/ns#",
@@ -105,7 +109,7 @@
     "Transformation": "csvw:Transformation",
     "aboutUrl": {
       "@id": "csvw:aboutUrl",
-      "@type": "@id"
+      "@type": "csvw:uriTemplate"
     },
     "base": {
       "@id": "csvw:base",
@@ -237,7 +241,7 @@
     },
     "propertyUrl": {
       "@id": "csvw:propertyUrl",
-      "@type": "@id"
+      "@type": "csvw:uriTemplate"
     },
     "quoteChar": {
       "@id": "csvw:quoteChar",
@@ -247,6 +251,9 @@
       "@id": "csvw:reference",
       "@type": "@id"
     },
+    "referencedRows": {
+      "@id": "csvw:referencedRow"
+    },
     "required": {
       "@id": "csvw:required",
       "@type": "xsd:boolean"
@@ -260,6 +267,10 @@
       "@type": "@id",
       "@container": "@set"
     },
+    "rowTitles": {
+      "@id": "csvw:rowTitle",
+      "@language": null
+    },
     "rownum": {
       "@id": "csvw:rownum",
       "@type": "xsd:integer"
@@ -339,7 +350,7 @@
     },
     "valueUrl": {
       "@id": "csvw:valueUrl",
-      "@type": "@id"
+      "@type": "csvw:uriTemplate"
     },
     "virtual": {
       "@id": "csvw:virtual",
@@ -358,6 +369,9 @@
       "dc:description": {
         "@container": "@language"
       },
+      "dc:date": {
+        "@type": "xsd:date"
+      },
       "rdfs:comment": {
         "@container": "@language"
       },
@@ -370,6 +384,9 @@
       "rdfs:range": {
         "@type": "@id"
       },
+      "rdfs:seeAlso": {
+        "@type": "@id"
+      },
       "rdfs:subClassOf": {
         "@type": "@id"
       },
@@ -390,8 +407,7 @@
         "@type": "@id"
       },
       "owl:versionInfo": {
-        "@type": "xsd:string",
-        "@language": null
+        "@type": "@id"
       },
       "owl:inverseOf": {
         "@type": "@vocab"
@@ -425,6 +441,14 @@
     "dc:description": {
       "en": "This document describes the RDFS vocabulary description used in the Metadata Vocabulary for Tabular Data [[tabular-metadata]] along with the default JSON-LD Context."
     },
+    "dc:date": "2017-05-23",
+    "owl:imports": [
+      "http://www.w3.org/ns/prov"
+    ],
+    "owl:versionInfo": "https://github.com/w3c/csvw/commit/94898e9f0b073aa09b3334ded2eb5ab3b87b37a9",
+    "rdfs:seeAlso": [
+      "http://www.w3.org/TR/tabular-metadata"
+    ],
     "rdfs_classes": [
       {
         "@id": "csvw:Cell",
@@ -565,7 +589,7 @@
           "en": "about URL"
         },
         "rdfs:comment": {
-          "en": "A URI template property that may be used to create a unique identifier for each cell within a row when mapping data to other formats."
+          "en": "A URI template property that MAY be used to indicate what a cell contains information about."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -584,7 +608,7 @@
           "en": "base"
         },
         "rdfs:comment": {
-          "en": "An atomic property that contains a single string: a term defined in the default context representing a built-in datatype URL."
+          "en": "An atomic property that contains a single string: a term defined in the default context representing a built-in datatype URL, as listed above."
         },
         "rdfs:domain": "csvw:Datatype",
         "rdfs:range": "xsd:string"
@@ -596,7 +620,7 @@
           "en": "column reference"
         },
         "rdfs:comment": {
-          "en": "A column reference property that holds either a single reference to a column description object within this schema, or an array of references."
+          "en": "A column reference property that holds either a single reference to a column description object within this schema, or an array of references. These form the referencing columns for the foreign key definition."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -613,7 +637,7 @@
           "en": "column"
         },
         "rdfs:comment": {
-          "en": "An array property of column descriptions as described in section 4.9 Columns."
+          "en": "An array property of column descriptions as described in section 5.6 Columns."
         },
         "rdfs:domain": "csvw:Schema",
         "rdfs:range": "csvw:Column"
@@ -625,7 +649,7 @@
           "en": "comment prefix"
         },
         "rdfs:comment": {
-          "en": "An atomic property that sets the comment prefix flag to the single provided value, which must be a single character string."
+          "en": "An atomic property that sets the comment prefix flag to the single provided value, which MUST be a string."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:string"
@@ -637,7 +661,7 @@
           "en": "datatype"
         },
         "rdfs:comment": {
-          "en": "An atomic property that contains either a single string that is the main datatype of the values of the cell or a datatype description object."
+          "en": "An object property that contains either a single string that is the main datatype of the values of the cell or a datatype description object. If the value of this property is a string, it MUST be one of the built-in datatypes defined in section 5.11.1 Built-in Datatypes or an absolute URL; if it is an object then it describes a more specialised datatype."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -661,7 +685,7 @@
           "en": "decimal character"
         },
         "rdfs:comment": {
-          "en": "An atomic property containing a single character string whose value is used to represent a decimal point within the number."
+          "en": "A string whose value is used to represent a decimal point within the number."
         },
         "rdfs:domain": "csvw:NumericFormat",
         "rdfs:range": "xsd:string"
@@ -703,7 +727,7 @@
           "en": "delimiter"
         },
         "rdfs:comment": {
-          "en": "An atomic property that sets the delimiter flag to the single provided value, which must be a single character string."
+          "en": "An atomic property that sets the delimiter flag to the single provided value, which MUST be a string."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:string"
@@ -715,7 +739,7 @@
           "en": "dialect"
         },
         "rdfs:comment": {
-          "en": "Provides hints to processors about how to parse the referenced files for to create tabular data models for an individual table, or all the tables in a group."
+          "en": "An object property that provides a single dialect description. If provided, dialect provides hints to processors about how to parse the referenced files to create tabular data models for the tables in the group."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -732,7 +756,7 @@
           "en": "double quote"
         },
         "rdfs:comment": {
-          "en": "A boolean atomic property that, if `true`, sets the escape character flag to `\"`. If `false`, to `\\\\`."
+          "en": "A boolean atomic property that, if `true`, sets the escape character flag to `\"`."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:boolean"
@@ -744,7 +768,7 @@
           "en": "encoding"
         },
         "rdfs:comment": {
-          "en": "An atomic property that sets the encoding flag to the single provided string value, which must be a defined [encoding]."
+          "en": "An atomic property that sets the encoding flag to the single provided string value, which MUST be a defined in [[encoding]]. The default is \"utf-8\"."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:string"
@@ -756,9 +780,14 @@
           "en": "foreign key"
         },
         "rdfs:comment": {
-          "en": "An array property of foreign key definitions that define how the values from specified columns within this table link to rows within this table or other tables."
+          "en": "For a Table: a list of foreign keys on the table.\n\nFor a Schema: an array property of foreign key definitions that define how the values from specified columns within this table link to rows within this table or other tables."
+        },
+        "rdfs:domain": {
+          "owl:unionOf": [
+            "csvw:Table",
+            "csvw:Schema"
+          ]
         },
-        "rdfs:domain": "csvw:Schema",
         "rdfs:range": "csvw:ForeignKey"
       },
       {
@@ -768,7 +797,7 @@
           "en": "format"
         },
         "rdfs:comment": {
-          "en": "An atomic property that contains either a single string or an object that defines the format of a value of this type."
+          "en": "An atomic property that contains either a single string or an object that defines the format of a value of this type, used when parsing a string value as described in Parsing Cells in [[tabular-data-model]]."
         },
         "rdfs:domain": "csvw:Datatype",
         "rdfs:range": "xsd:string"
@@ -780,7 +809,7 @@
           "en": "group character"
         },
         "rdfs:comment": {
-          "en": "An atomic property containing a single character string whose value is used to group digits within the number."
+          "en": "A string whose value is used to group digits within the number."
         },
         "rdfs:domain": "csvw:NumericFormat",
         "rdfs:range": {
@@ -809,7 +838,7 @@
           "en": "header row count"
         },
         "rdfs:comment": {
-          "en": "The number of header rows (following the skipped rows) in the file. The default is 1."
+          "en": "An numeric atomic property that sets the header row count flag to the single provided value, which must be a non-negative integer."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:nonNegativeInteger"
@@ -821,7 +850,7 @@
           "en": "language"
         },
         "rdfs:comment": {
-          "en": "An atomic property giving a single string language code as defined by [BCP47]."
+          "en": "An atomic property giving a single string language code as defined by [[BCP47]]."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -849,10 +878,10 @@
         "@id": "csvw:lineTerminators",
         "@type": "rdf:Property",
         "rdfs:label": {
-          "en": "line terminator"
+          "en": "line terminators"
         },
         "rdfs:comment": {
-          "en": "An atomic property that is either an array containing the single provided string value"
+          "en": "An atomic property that sets the line terminators flag to either an array containing the single provided string value, or the provided array."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:string"
@@ -936,7 +965,7 @@
           "en": "name"
         },
         "rdfs:comment": {
-          "en": "An atomic property that gives a canonical name for the column. This must be a string. Conversion specifications must use this property as the basis for the names of properties/elements/attributes in the results of conversions."
+          "en": "An atomic property that gives a single canonical name for the column. The value of this property becomes the name annotation for the described column."
         },
         "rdfs:domain": "csvw:Column",
         "rdfs:range": "xsd:string"
@@ -948,7 +977,7 @@
           "en": "note"
         },
         "rdfs:comment": {
-          "en": "The value of this property becomes the value of the notes annotation on the resource."
+          "en": "An array property that provides an array of objects representing arbitrary annotations on the annotated tabular data model."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -964,7 +993,7 @@
           "en": "null"
         },
         "rdfs:comment": {
-          "en": "An atomic property giving the string or strings used for null values within the data."
+          "en": "An atomic property giving the string or strings used for null values within the data. If the string value of the cell is equal to any one of these values, the cell value is `null`."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1002,7 +1031,7 @@
           "en": "pattern"
         },
         "rdfs:comment": {
-          "en": "An atomic property containing a regular expression string, in the syntax and interpreted as defined by [ECMASCRIPT]."
+          "en": "A regular expression string, in the syntax and interpreted as defined by [[ECMASCRIPT]]."
         },
         "rdfs:domain": "csvw:NumericFormat",
         "rdfs:range": "xsd:string"
@@ -1014,9 +1043,14 @@
           "en": "primary key"
         },
         "rdfs:comment": {
-          "en": "A column reference property that holds either a single reference to a column description object or an array of references."
+          "en": "For Schema: A column reference property that holds either a single reference to a column description object or an array of references.\n\nFor Row: a possibly empty list of cells whose values together provide a unique identifier for this row. This is similar to the name of a column."
+        },
+        "rdfs:domain": {
+          "owl:unionOf": [
+            "csvw:Schema",
+            "csvw:Row"
+          ]
         },
-        "rdfs:domain": "csvw:Schema",
         "rdfs:range": "xsd:string"
       },
       {
@@ -1026,7 +1060,7 @@
           "en": "property URL"
         },
         "rdfs:comment": {
-          "en": "An URI template property that may be used to create a URI for a property if the table is mapped to another format."
+          "en": "An URI template property that MAY be used to create a URI for a property if the table is mapped to another format. "
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1045,7 +1079,7 @@
           "en": "quote char"
         },
         "rdfs:comment": {
-          "en": "An atomic property that sets the quote character flag to the single provided value, which must be a single character."
+          "en": "An atomic property that sets the quote character flag to the single provided value, which must be a string or `null`."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:string"
@@ -1057,11 +1091,22 @@
           "en": "reference"
         },
         "rdfs:comment": {
-          "en": "An object property that identifies a referenced table and a set of referenced columns within that table."
+          "en": "An object property that identifies a **referenced table** and a set of **referenced columns** within that table."
         },
         "rdfs:domain": "csvw:ForeignKey",
         "rdfs:range": "csvw:TableReference"
       },
+      {
+        "@id": "csvw:referencedRow",
+        "@type": "rdf:Property",
+        "rdfs:label": {
+          "en": "referenced rows"
+        },
+        "rdfs:comment": {
+          "en": "A possibly empty list of pairs of a foreign key and a row in a table within the same group of tables."
+        },
+        "rdfs:domain": "csvw:Row"
+      },
       {
         "@id": "csvw:required",
         "@type": "rdf:Property",
@@ -1069,9 +1114,16 @@
           "en": "required"
         },
         "rdfs:comment": {
-          "en": "A boolean value which indicates whether every cell within the column must have a non-null value."
+          "en": "A boolean atomic property taking a single value which indicates whether the cell must have a non-null value. The default is `false`. "
+        },
+        "rdfs:domain": {
+          "owl:unionOf": [
+            "csvw:TableGroup",
+            "csvw:Table",
+            "csvw:Schema",
+            "csvw:Column"
+          ]
         },
-        "rdfs:domain": "csvw:Column",
         "rdfs:range": "xsd:boolean"
       },
       {
@@ -1099,6 +1151,18 @@
         "rdfs:domain": "csvw:Table",
         "rdfs:range": "csvw:Row"
       },
+      {
+        "@id": "csvw:rowTitle",
+        "@type": "rdf:Property",
+        "rdfs:label": {
+          "en": "row titles"
+        },
+        "rdfs:comment": {
+          "en": "A column reference property that holds either a single reference to a column description object or an array of references."
+        },
+        "rdfs:domain": "csvw:Schema",
+        "rdfs:range": "xsd:string"
+      },
       {
         "@id": "csvw:rownum",
         "@type": "rdf:Property",
@@ -1106,7 +1170,7 @@
           "en": "row number"
         },
         "rdfs:comment": {
-          "en": "The position of the row amongst the rows of the Annotated Tabl, starting from 1 "
+          "en": "The position of the row amongst the rows of the Annotated Tabl, starting from 1"
         },
         "rdfs:range": "xsd:integer"
       },
@@ -1141,7 +1205,7 @@
           "en": "separator"
         },
         "rdfs:comment": {
-          "en": "An atomic property that must have a single string value that is the character used to separate items in the string value of the cell."
+          "en": "An atomic property that MUST have a single string value that is the character used to separate items in the string value of the cell."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1160,7 +1224,7 @@
           "en": "skip blank rows"
         },
         "rdfs:comment": {
-          "en": "An boolean atomic property that sets the skip blank rows flag to the single provided boolean value."
+          "en": "An boolean atomic property that sets the `skip blank rows` flag to the single provided boolean value."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:boolean"
@@ -1172,7 +1236,7 @@
           "en": "skip columns"
         },
         "rdfs:comment": {
-          "en": "An numeric atomic property that sets the skip columns flag to the single provided numeric value, which must be a non-negative integer."
+          "en": "An numeric atomic property that sets the `skip columns` flag to the single provided numeric value, which MUST be a non-negative integer."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:nonNegativeInteger"
@@ -1184,7 +1248,7 @@
           "en": "skip initial space"
         },
         "rdfs:comment": {
-          "en": "A boolean atomic property that, if `true`, sets the trim flag to \"start\". If `false`, to `false`. If the trim property is provided, the skipInitialSpace property is ignored."
+          "en": "A boolean atomic property that, if `true`, sets the trim flag to \"start\". If `false`, to `false`."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:boolean"
@@ -1196,7 +1260,7 @@
           "en": "skip rows"
         },
         "rdfs:comment": {
-          "en": "An numeric atomic property that sets the skip rows flag to the single provided numeric value, which must be a non-negative integer."
+          "en": "An numeric atomic property that sets the `skip rows` flag to the single provided numeric value, which MUST be a non-negative integer."
         },
         "rdfs:domain": "csvw:Dialect",
         "rdfs:range": "xsd:nonNegativeInteger"
@@ -1220,7 +1284,7 @@
           "en": "suppress output"
         },
         "rdfs:comment": {
-          "en": "A boolean atomic property. If true, suppresses any output that would be generated when converting a table or cells within a column."
+          "en": "A boolean atomic property. If `true`, suppresses any output that would be generated when converting a table or cells within a column."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1250,7 +1314,7 @@
           "en": "table direction"
         },
         "rdfs:comment": {
-          "en": "One of csvw:rtl csvw:ltr or csvw:default. Indicates whether the tables in the group should be displayed with the first column on the right, on the left, or based on the first character in the table that has a specific direction."
+          "en": "One of `rtl`, `ltr` or `auto`. Indicates whether the tables in the group should be displayed with the first column on the right, on the left, or based on the first character in the table that has a specific direction."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1267,7 +1331,7 @@
           "en": "table schema"
         },
         "rdfs:comment": {
-          "en": "An object property that provides a single schema description as described in section 4.8 Schemas, used as the default for all the tables in the group"
+          "en": "An object property that provides a single schema description as described in section 5.5 Schemas, used as the default for all the tables in the group"
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1315,7 +1379,7 @@
           "en": "text direction"
         },
         "rdfs:comment": {
-          "en": "An atomic property that must have a single value that is one of csvw:rtl or csvw:ltr (the default)."
+          "en": "An atomic property that must have a single value that is one of `rtl` or `ltr` (the default)."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1339,7 +1403,8 @@
         "rdfs:domain": {
           "owl:unionOf": [
             "csvw:Transformation",
-            "csvw:Column"
+            "csvw:Column",
+            "csvw:Row"
           ]
         }
       },
@@ -1379,7 +1444,7 @@
           "en": "valueUrl"
         },
         "rdfs:comment": {
-          "en": "An URI template property that is used to map the values to the cells into URLs."
+          "en": "An URI template property that is used to map the values of cells into URLs."
         },
         "rdfs:domain": {
           "owl:unionOf": [
@@ -1425,10 +1490,30 @@
         "rdfs:comment": {
           "en": ""
         },
-        "rdfs:subClassOf": "xsd:anyURI"
+        "rdfs:subClassOf": "xsd:string"
       }
     ],
     "rdfs_instances": [
+      {
+        "@id": "csvw:auto",
+        "@type": "Direction",
+        "rdfs:label": {
+          "en": "auto"
+        },
+        "rdfs:comment": {
+          "en": "Indicates whether the tables in the group should be displayed based on the first character in the table that has a specific direction."
+        }
+      },
+      {
+        "@id": "csvw:inherit",
+        "@type": "Direction",
+        "rdfs:label": {
+          "en": "inherit"
+        },
+        "rdfs:comment": {
+          "en": "For `textDirection`, indicates that the direction is inherited from the `tableDirection` annotation of the `table`."
+        }
+      },
       {
         "@id": "csvw:ltr",
         "@type": "Direction",
@@ -1436,7 +1521,7 @@
           "en": "left to right"
         },
         "rdfs:comment": {
-          "en": "Indicates text should be processed left to right."
+          "en": "Indicates whether the tables in the group should be displayed with the first column on the right."
         }
       },
       {
@@ -1446,7 +1531,7 @@
           "en": "right to left"
         },
         "rdfs:comment": {
-          "en": "Indiects text should be processed right to left"
+          "en": "Indicates whether the tables in the group should be displayed with the first column on the left."
         }
       },
       {