Promote "Metadata in Table Schema" recipe to the specs.

frictionlessdata / datapackage

Data Package is a standard consisting of a set of simple yet extensible specifications to describe datasets, data files and tabular data. It is a data definition language (DDL) and data API that facilitates findability, accessibility, interoperability, and reusability (FAIR) of data.

https://datapackage.org

The Unlicense

482 stars 109 forks source link

Promote "Metadata in Table Schema" recipe to the specs. #961

Open pierrecamilleri opened 1 week ago

pierrecamilleri commented 1 week ago

Context and related issue : fix #899

Migrated pull request from datapackage-v2-draft repo

Still to do on this PR:

[x] Move table schema to /standards/table-schema.md (cf. main)
[X] Move changelog to /overview/changelog.md (cf. main)
[x] Update wording so it aligns with Data Package (my pending PR)
[x] Update some links
[x] Fix invalid json example (it was an unintended change)
[ ] Clarify if examples are borrowing title and path from Data Resource (I think they are, included in my PR) or if this is something completely separate.

roll commented 1 week ago

Thanks a lot for rebasing the PR @pierrecamilleri !

pierrecamilleri commented 3 days ago

@peterdesmet @roll

Almost there.

I added "partial" to qualify "Data Resource" in the suggestion of Peter concerning the documentation of top-level "examples" ; because an object with title and path is not a valid Data Resource (name is missing). Or do we want to impose a name property ? What do you think of this wording ?