From 1eebc03cf77ec4d510285295fdc3909e45a4a0c2 Mon Sep 17 00:00:00 2001 From: Gregg Kellogg Date: Sun, 12 Apr 2015 14:13:32 -0700 Subject: [PATCH 1/2] Update `titles` in metadata and syntax by suggest by @iherman in https://github.com/w3c/csvw/pull/469#issuecomment-91500186: > The title property in the syntax is defined as "any number of human-readable titles for the column, each of which has an associated language represented as an object whose properties MUST be language codes as defined by [[!BCP47]] and whose values are arrays of strings related to that language." Is this correct, grammatically? But, more importantly... I personally would have preferred to keep it as it was, i.e., something like "any number of human readable titles for the column, each of which with an associated language as defined in [[!BCP47]]". However, if we do that change, the metadata document has to change, to (for natural language properties) so I did not do any change. --- metadata/index.html | 4 ++-- syntax/index.html | 2 +- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/metadata/index.html b/metadata/index.html index e9c6d7bf..fe0e4823 100644 --- a/metadata/index.html +++ b/metadata/index.html @@ -1030,9 +1030,9 @@

Columns

titles

- A natural language property that provides possible alternative names for the column. The value of this property becomes the titles annotation for the described column. + A natural language property that provides possible alternative names for the column. The string value(s) of this property, along with any associated language tag, becomes the titles annotation for the described column.

-

If there is no name property defined on this column, the first titles string value having the same language tag as default language or und or if not specified, becomes the name annotation for the described column. This annotation MUST be percent-encoded as necessary to conform to the syntactic requirements defined in [[!RFC3986]]

+

If there is no name property defined on this column, the first titles value having the same language tag as default language or und or if not specified, becomes the name annotation for the described column. This annotation MUST be percent-encoded as necessary to conform to the syntactic requirements defined in [[!RFC3986]]

virtual
diff --git a/syntax/index.html b/syntax/index.html index 0b0a4f2f..c96f68c5 100644 --- a/syntax/index.html +++ b/syntax/index.html @@ -252,7 +252,7 @@

Columns

  • suppress output — a boolean that indicates whether or not this column should be suppressed in any output generated from converting the table, as described in .
  • table — the table in which the column appears.
  • text direction — the indicator of the text direction values of cells in this column, as described in .
    • -
  • titles — any number of human-readable titles for the column, each of which has an associated language represented as an object whose properties MUST be language codes as defined by [[!BCP47]] and whose values are arrays of strings related to that language.
    • +
  • titles — any number of human-readable titles for the column, which MAY have an associated language code as defined by [[!BCP47]].
  • value URL — the expected value URL URI template used to create the URL identifier for the value of each cell in this, as defined in [[!tabular-metadata]].
  • virtual — a boolean that indicates whether the column is a virtual column. Virtual columns are used to extend the source data with additional empty columns to support more advanced conversions; when this annotation is false, the column is a real column, which exists in the source data for the table.
    • From 8fe554c5d1009052ad0e3ac3edd17a615423cf08 Mon Sep 17 00:00:00 2001 From: Jeni Tennison Date: Sun, 12 Apr 2015 17:56:43 -0400 Subject: [PATCH 2/2] small tweaks to wording --- metadata/index.html | 2 +- syntax/index.html | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/metadata/index.html b/metadata/index.html index fe0e4823..487b343d 100644 --- a/metadata/index.html +++ b/metadata/index.html @@ -1030,7 +1030,7 @@

    Columns

    titles

    - A natural language property that provides possible alternative names for the column. The string value(s) of this property, along with any associated language tag, becomes the titles annotation for the described column. + A natural language property that provides possible alternative names for the column. The string values of this property, along with their associated language tags, become the titles annotation for the described column.

    If there is no name property defined on this column, the first titles value having the same language tag as default language or und or if not specified, becomes the name annotation for the described column. This annotation MUST be percent-encoded as necessary to conform to the syntactic requirements defined in [[!RFC3986]]

    diff --git a/syntax/index.html b/syntax/index.html index c96f68c5..403a92b6 100644 --- a/syntax/index.html +++ b/syntax/index.html @@ -252,7 +252,7 @@

    Columns

  • suppress output — a boolean that indicates whether or not this column should be suppressed in any output generated from converting the table, as described in .
  • table — the table in which the column appears.
  • text direction — the indicator of the text direction values of cells in this column, as described in .
    • -
  • titles — any number of human-readable titles for the column, which MAY have an associated language code as defined by [[!BCP47]].
    • +
  • titles — any number of human-readable titles for the column, each of which MAY have an associated language code as defined by [[!BCP47]].
  • value URL — the expected value URL URI template used to create the URL identifier for the value of each cell in this, as defined in [[!tabular-metadata]].
  • virtual — a boolean that indicates whether the column is a virtual column. Virtual columns are used to extend the source data with additional empty columns to support more advanced conversions; when this annotation is false, the column is a real column, which exists in the source data for the table.