RO-Crate 1.1 changelog

[stain]

Add to the beginning of RO-Crate 1.1 a brief list of changes since 1.0.

The list can link to github issues/pull requests.

From top of my head:

• ro-crate-metadata.jsonld -> ro-crate-metadata.json
• Workflow -> ComputationalWorkflow

[ptsefton]

Implementation notes added about how to process a crate
Advice about including Property and Class definitions as per the Schema.org approach

[stain]

All commits since 1.0 are on the 1.1-DRAFT folder that was copied from 1.0:

https://github.com/ResearchObject/ro-crate/commits/75001bae93b11035f919/docs/1.1-DRAFT

• Note: The RO-Crate metadata file is renamed to ro-crate-metadata.json to facilitate use of JSON editors. (Use Case: Metadata file should open in JSON editors #82 Addressed #82 - changing the name of the RO Crate Metadata File #84)
• Data entities can reference external resources with absolute URI (Adding @id for external URIs #74)
• Added section on considerations for Web-based Data Entities (Adding @id for external URIs #74)
• The root dataset is no longer required to be ./ (Adding @id for external URIs #74)
• RO-Crate Root directory no longer requires payload files (Adding @id for external URIs #74)
• Workflows and scripts section now aligned with BioSchemas ComputationalWorkflow profile (Alignment with Bioschemas profile Workflow 0.5 #81)
• Added section Programming with JSON-LD and note that @type might be an array (Added some notes about type arrays and notes on defensive programming #85)
• Added new section Handling relative URI references (Avoid @base: null as it breaks parsing as RDF #73)
• JSON-LD context no longer sets @base: null (Avoid @base: null as it breaks parsing as RDF #73)
• Added note on Encoding file paths (Doc update : make it clear that Dataset @id is a URIPath w/ *nix separators #77 Make it clear that @id is URIpath with / seperators #80)
• Added section Choosing URLs for ad hoc terms (Use Case: As a researcher I want to be able to define ad hoc properties and use them in a crate without resorting to the verbose PropertyValue thing #71 How to specify ad-hoc properties #90)
• Section RO-Crate JSON-LD Media type expanded to suggest HTTP server configuration
• Update JSON-LD context to schema.org 10.0
• Fixed some JSON typos

[stain]

See https://www.researchobject.org/ro-crate/1.1-DRAFT/appendix/changelog.html