APPENDIX: Changelog

• RO-Crate 1.2.0 https://w3id.org/ro/crate/1.2
  • Clarified that the RO-Crate Metadata Descriptor MUST have @id of ro-crate-metadata.json by removing conflicting statements elsewhere in the specification #365
  • Updated the Bioschemas namespace for properties from https://bioschemas.org/ComputationalWorkflow# to https://bioschemas.org/properties/. This change affects only the input and output properties in the JSON-LD context.
  • Change: Replaced name-based algorithm for finding root #198 #365
  • Updated algorithm to always use string filter to find root #189 #421 (see algorithm)
  • Change: Files on the web should now use contentUrl for direct download #259
  • Clarify entity terminology and when File/Dataset entities are and are not data entities #204 #426
  • Update JSON-LD context to schema.org 22.0. Note that upstream adds >230 terms, and removed terms AuthenticContent MissingContext, constrainingProperty (now constraintProperty), measuredValue, observedNode . #263 #274
  • Remove custom mapping of funding for Bioschemas (now officially http://schema.org/funding)
  • Added localPath to JSON-LD context (https://w3id.org/ro/terms#localPath) and described its use in web-based entities #406 #390
  • Updated for ComputationalWorkflow 1.0 profile #185
  • Clarified Directories on the web format is a media type, not extension #205
  • New: Extended introduction with a running example #227 #215 #219 – see also RO-Crate tutorials.
  • New: Added section Profiles and the concept Profile Crate #250 #251 #255 #256 #407
  • Define terms for Profiles #248
  • Added subsection for grouping extensions in a profile #233 #233
  • Allow more types on root #182 #223
  • Added subsection on root data entity identifier #183
  • New: Introduces distinction of Attached/Detached RO-Crate #248 #189 #183 #390 #405
  • Included Attached/Detached RO-Crate in terminology #248
  • Rephrased description of payload files #183 #189
  • Describes ro-crate-preview.html as entity #106 #210
  • Added usage of DefinedTerm; rdfs:label and comment optional; replaced example #232 #208 #106
  • Added section on converting Attached/Detached RO-Crates #189
  • Added Common principles for RO-Crate entities #225 #260 #404
  • Added note on ELN (Electronic Lab Notebook) implementation to appendix section on combining with other packaging schemes #389
  • Clarified mandatory metadata for the Root Data Entity #404
  • Many sections reviewed to improve language and examples #378 #382 #404 #410 #411 #412 #413 #414 #415 #418 #425
• RO-Crate 1.1.2
  • Typo fixes in data entity section #177, workflow section #180, metadata section #181
  • Correct namespace for rdfs:comment on ad-hoc terms #164
  • Fixed broken links to Bioschemas and SPAR ontologies #185 (note: conformsTo URIs unchanged, will be updated in RO-Crate 1.2)
• RO-Crate 1.1.1
  • Introduction highlight not all Data entities are files #125 #127
• RO-Crate 1.1.0 https://w3id.org/ro/crate/1.1
  • Note: The RO-Crate metadata file is renamed to ro-crate-metadata.json to facilitate use of JSON editors. #82 #84
  • Data entities can reference external resources with absolute URI #74
  • Added section on considerations for Web-based Data Entities #74
  • The Root Data Entity is no longer required to be ./ #74
  • RO-Crate Root directory no longer requires payload files #74
  • Workflows and scripts section now aligned with BioSchemas ComputationalWorkflow profile #81 #100
  • Added section Programming with JSON-LD and note that @type might be an array #85
  • Added new section Handling relative URI references #73
  • JSON-LD context no longer sets @base: null #73
  • Added note on Encoding file paths #77 #80
  • Added section Choosing URLs for ad hoc terms #71 #90
  • Section RO-Crate JSON-LD Media type expanded to suggest HTTP server configuration
  • Update JSON-LD context to Schema.org 10.0
  • Remove HTML use of relatedLink property in RepositoryCollection example #91
  • Distinguish between contextual/data entities #94
  • RO-Crate preview HTML no longer needs to “contain same information as JSON-LD” #108
  • Change theme to jekyll-rtd-theme and split into multiple pages #95
  • Fixed typos in JSON and English
  • Additional metadata standards showed wrong PCDM namespace #112
  • Citation example expanded 12a6754
  • Terminology adds property, type, entity cc10e28
  • In People author can also be applied to CreativeWork e086b8b
  • Provenance section on Software-used now points to Workflows section (and vice versa) 5d89872 40de6c7
  • In JSON-LD appendix @id should not include ../ 74ef6f1
  • Several sections reviewed to improve language and examples #91 #92 #93 #94 #96 #97 #98 #101 #102 #103 #104 #105 #111 #114
• RO-Crate 1.0.1
  • Fix JSON typo in example
• RO-Crate 1.0.0 https://w3id.org/ro/crate/1.0
  • Description of RO-Crate Metadata File now required
    • .. must use conformsTo to indicate RO-Crate version
  • Clarified use of RO-Crate JSON-LD Context
  • Linked Data principles added
  • RO-Crate JSON-LD Context updated to use Schema.org 5.0
  • Workflow and Script now typed with @type array instead of additionalType
  • Simplified tables of direct properties to list of properties
  • Simplified example of affiliation
  • Clarified #identifiers and _:identifiers
  • Removed links to data.research.uts.edu.au examples
  • Added licensing of metadata
  • Expanded on Equipment used to create files
  • Simplified Workflow and Script section
  • Added appendix on JSON-LD
  • Added BagIt implementation notes
  • Added Repository-specific identifiers
  • RO-Crate JSON-LD now licensed CC0
  • RO-Crate JSON-LD self-identifies its version
• RO-Crate 0.2.1
  • Added DOI and document metadata
• RO-Crate 0.2.0 https://w3id.org/ro/crate/0.2
  • Based on two earlier specifications:
    • RO Lite 0.1.0
    • DataCrate Specification version 1.0.0 2019-04-12
  • RO-Crate Metadata file has been renamed to ro-crate-metadata.jsonld instead of CATALOG.json (DataCrate) or manifest.jsonld (RO-Lite)
  • RO Crate Website renamed to ro-crate-metadata.html instead of DataCrate’s CATALOG.html
  • “RO-Lite” and “DataCrate” renamed to “RO-Crate”
  • Multiple examples and clarifications added
  • RO-Crate directory no longer requires BagIt structure
  • Added section on Workflows and scripts
  • RO-Crate Metadata File must describe itself as being about the RO-Crate Dataset.
  • JSON-LD should now be flattened and then compacted (RO-Lite allowed any JSON-LD, DataCrate required flattened)