APPENDIX: Changelog

• RO-Crate 1.3.0

  • Notable change: Updated the Bioschemas namespace to https://bioschemas.org/terms/ for all types and properties (previously https://bioschemas.org/ for types and https://bioschemas.org/properties for properties). This change affects 4 terms in the JSON-LD context: ComputationalWorkflow, FormalParameter, input, and output. This is primarily relevant to those describing workflows with RO-Crate, either using the Workflows and Scripts chapter or the Workflow RO-Crate profile and its derivatives. #529

    Term	Previous URI	New URI
    ComputationalWorkflow	https://bioschemas.org/ComputationalWorkflow	https://bioschemas.org/terms/ComputationalWorkflow
    FormalParameter	https://bioschemas.org/FormalParameter	https://bioschemas.org/terms/FormalParameter
    input	https://bioschemas.org/properties/input	https://bioschemas.org/terms/input
    output	https://bioschemas.org/properties/output	https://bioschemas.org/terms/output

  • Update schema.org to v30.0. This update adds many new terms and removes none. None of the new terms are used in the 1.3 specification. Some of them may however be of interest to profile creators, including AuthenticateAction, Certification, Credential, Error, InstantaneousEvent, LoginAction, OperatingSystem, RuntimePlatform, pronouns, various types of source for digital objects to be used with digitalSourceType, and other properties associated with the classes above.
  • All other changes listed below are minor and are also applied to the web version of RO-Crate 1.2.
  • Fix error in appendix section Converting from Attached to Detached RO-Crate Package; the metadata descriptor must be ro-crate-metadata.json and should not be converted to an absolute path. ro-crate#538 #524
  • Add relevant missing rdfs: properties to core RO-Crate Profile Crate #471
  • Fix typos & incorrect links #169, #527
  • Improve page metadata for better previews/SEO (no content changed) #499
• 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)