Re-use schema.org schemas

[sverhoeven]

Copied from https://github.com/eStep/eStep/issues/1

Created by @blootsvoets

Briefly looking at JSON-LD and @context and @type, for our naming conventions in our schema's, would it be useful to look at http://schema.org?

E.g. Software: https://schema.org/SoftwareApplication Person: https://schema.org/Person Organization: https://schema.org/Organization

The Project schema does not exist, nor does a Collaboration or Funding (I couldn’t think of a good synonym), that could be a good contribution?

@mkuzak commented 2 days ago

1 one for using schema.org

@blootsvoets commented 2 days ago

Btw, stackoverflow and this very page also use schema.org:

# @mkuzak commented 2 days ago schema.org is very actively developed project, there is even project for life sciences 'BioSchemas' for bio-related metadata. Search engines use it to to reason about the pages, all the summaries that we see in google results on the right side are generated based on schema.org used by indexed websites. There is very handy tool from google to test schema use: https://developers.google.com/structured-data/testing-tool/ # @wrvhage commented a day ago Yes. As soon as we start with the JSON-LD additions, we should add the appropriate Schema.org annotations.

[blootsvoets]

Another nice thing about JSON-LD is that it accepts arrays and single items for each property. In JSON Schema, this distinction has to be made. We can use the following construct for that (for example, a string property):

anyOf: [
  {type: "array", items: {type: "string"}},
  {type: "string"}
]