w3c / csvw

Documents produced by the CSV on the Web Working Group
Other
161 stars 57 forks source link

Unclear example for embedded metadata #873

Open Evidlo opened 3 years ago

Evidlo commented 3 years ago

Example 7 demonstrates the use of embedded metadata to hold information about the author, creation date, column datatypes, etc.

  1. Is there some explanation for why a delimiter precedes publisher and updated, but not name or datatype?

  2. If commentPrefix is null by default, does that mean it's not possible to ship a csv with embedded metadata using the default dialect?

Also, it seems the tabs in example 7 have been converted to spaces, but they are intact in example 21.

gkellogg commented 3 years ago

There is no normative specification for embedded metadata. This example is intended as an example for how embedded metadata might work, if it were to be specified.

In the case of example 7, I believe the first two comments would be interpreted as general comments on the table, and #name and #datatype as specifying specific information about name, and datatype fields in particular, but it's just hypothetical.

The only metadata standard defined by this WG is Metadata Vocabulary for Tabular Data, which is based on JSON-LD in a separate file.