Review RO-Crate 1.2-DRAFT

[stain]

All: Help review 1.2-DRAFT, we need an volunteers per section.

@context is for now https://w3id.org/ro/crate/1.2-DRAFT/context (note: newer Schema.org)

Note: For all changes, please edit corresponding Markdown file in docs/1.2-DRAFT/ in GitHub -- commit directly for typos, or do a Pull Request for anything else. No changes, just tick below.

Review assignments per section: (add your @username or comment which section's you'll take)

(..or edit in Google Docs Table)

• [x] 1.2-DRAFT/contextual-entities.html#contextual-vs-data-entities #204 (adds “not necessarily data entities”) @simleo --> #244
• [x] 1.2-DRAFT/contextual-entities.html#identifiers-for-contextual-entities
  (adds “it follows that RO-Crate Root is a data entity”) @simleo #244
• [x] 1.2-DRAFT/crate-focus #122 #124 #211 (new section) @simleo #244
• [x] 1.2-DRAFT/data-entities.html#referencing-files-and-folders-from-the-root-data-entity #204 @nsjuty
• [x] 1.2-DRAFT/data-entities.html#adding-detailed-descriptions-of-encodings #230 #99 (uses Standard class, replaced example) @ptsefton
• [x] 1.2-DRAFT/data-entities.html#file-format-profiles #231 (new subsection) @ljgarcia
• [x] 1.2-DRAFT/data-entities.html#file-data-entity
  (makes explicit that File SHOULD have name, description, encodingFormat, conformsTo, contentSize and Dataset SHOULD have name, description, hasPart) @nsjuty
• [x] 1.2-DRAFT/data-entities.html#directories-on-the-web-dataset-distributions
  (file format named as application/zip instead of .zip) @nsjuty
• [x] 1.2-DRAFT/introduction.html #227 #215 #219 (mostly new) @nsjuty --> #246
• [x] 1.2-DRAFT/metadata.html#additional-metadata-standards
  (new terms for profiles) @marc-portier
• [x] 1.2-DRAFT/profiles #153 #229 (new section, funding now in schema.org) @ptsefton --> #250 #251 #255 #256
• [x] 1.2-DRAFT/root-data-entity.html#ro-crate-metadata-file-descriptor #182 #223 (type may be an array, @id laxed) @ptsefton --> #249
• [x] 1.2-DRAFT/root-data-entity.html#finding-the-root-data-entity #198 (different algorithm)
• [x] 1.2-DRAFT/root-data-entity.html#root-data-entity-identifier
  (new subsection) @ljgarcia
• [x] 1.2-DRAFT/structure #189 #183 (adds distinction Attached/Detached RO-Crate) @ptsefton --> #248
• [x] 1.2-DRAFT/structure#payload-files-and-directories
  (rephrased on payload files)
• [x] 1.2-DRAFT/structure#ro-crate-website-ro-crate-previewhtml-and-ro-crate-preview_files #106 #210
  (allows ro-crate-preview.html as entity)
• [x] 1.2-DRAFT/terminology
  (adds Attached/Detached) @ptsefton --> #248
• [x] 1.2-DRAFT/workflows#complying-with-bioschemas-computational-workflow-profile
  (updated for ComputationalWorkflow 1.0 profile, uses DefinedTerm) @marc-portier
• [x] 1.2-DRAFT/appendix/jsonld.html#adding-new-or-ad-hoc-vocabulary-terms #232 #208 #106 (uses DefinedTerm with name/description; rdfs:label and rdfs:comment now optional) @abigail-miller --> #252
• [x] 1.2-DRAFT/appendix/jsonld.html#grouping-extensions-as-an-ro-crate-profile #233 (new subsection) @abigail-miller --> #252
• [x] 1.2-DRAFT/appendix/relative-uris.html#converting-from-attached-to-detached-ro-crate
  (new subsections for Attached/Detached conversion)
  • [x] Remove missing section Converting from Detached to Attached RO-Crate
• [x] 1.2-DRAFT/appendix/relative-uris.html#finding-ro-crate-root-in-rdf-triple-stores
  • Now always uses string filter in SPARQL to find root (see algorithm)
• x Specify cite-as and Signposting for root data entity #255 @ptsefton
• [x] List required properties for entities #260 @simleo
• [x] contentUrl for direct download, add section on Converting to Attached RO-Crate #259 @ptsefton

TODO:

• [x] Update Changelog according to RO-Crate 1.2 milestone and above list
• [x] Update author list
• [x] Update ro-crate-metadata.json (eat our own dogfood)

[simleo]

My assignments done in #244

[marc-portier]

slight glitich discovered:

profiles.md has line47 as a needless (confusing?) duplicate of line45

[stain]

Thanks everyone for help with reviewing!