scope notes, examples, in domain/range of

[VladimirAlexiev]

Related to #108 and euBusinessGraph/eubg-data#18, below is a list of the omissions of PyLODE compared to my patched LODE.

When euBusinessGraph/eubg-data#18 is fixed, the links below will be broken, but we'll keep the PyLODE example at https://github.com/euBusinessGraph/eubg-data/blob/master/ontology/pylode/doc.html.

---

Class WebResource

• old: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/_old/index.html#http://data.businessgraph.io/ontology#WebResource
• new: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/doc.html#WebResource
• missing:
  • is defined by
  • is in domain of
  • is in range of

Class RegisteredOrganization:

• old: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/_old/index.html#http://www.w3.org/ns/regorg#RegisteredOrganization
• new: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/doc.html#RegisteredOrganization
• missing:
  • Usage note / Scope note (skos:scopeNote): old allows multiple, new only one
  • examples (skos:example, multiple)

Property adminUnitL3

• old: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/_old/index.html#http://data.businessgraph.io/ontology#adminUnitL3
• new: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/doc.html#adminunitlevel3
• missing:
  • Usage note / Scope note (skos:scopeNote): old allows multiple, new only one
  • examples (skos:example, multiple)

Property identifier

• old: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/_old/index.html#d4e247
• new: http://rawgit2.com/euBusinessGraph/eubg-data/master/ontology/doc.html#identifier1
• missing:
  • Usage note / Scope note (skos:scopeNote): old allows multiple, new only the first one
  • examples (skos:example, multiple)
  • Neither renders markdown (bullets) in the scopeNotes

[nicholascar]

• I've changes "Usage Note" to "Scope Notes everywhere
  • better reflects the underlying SKOS property
• I've added Markdown support for properties

One of the issues with your examples above is that you are using http://schema.org but you should be using https://schema.org! In discussion with the schema.org people (@danbri) I've been only allowing the HTTPS version of schema.org everywhere, such as in RDFlib itself, not just pyLODE.

I've added an example of your EGB ontology to pyLODE's schedule of ontologies:

• Turtle
• HTML

I've made two changes to the RDF:

1. Used HTTPS for schema.org
2. Ensured correct Markdown
   • for one example property only, adms:identifier
   • see https://raw.githack.com/RDFLib/pyLODE/master/pylode/examples/ebg.html#identifier
   • the Python Markdown interpreter didn't like no newline between paragraphs and lists

With the first change, you can see domainIncludes, rangeIncludes for properties and the references to them for classes.

Regarding the multiple values for scos:scopeNote and example: no I haven't added support for multiple values yet, so best would just be to concatenate that text if you can. Now that there's Markdown support for those fields, this should be easy to do.

(you could put in a separate issue/PR to just deal with multiple filed values if you really must have them)

Also note that the skos:example fields use monospace so you can put in RDF code examples like this one:

• ResearchProject

There has to be a place for RDF examples, so we've chosen skos:example for it so plain text in other examples will have to do in other fields, like skos:scopeNote or just the main descriptions/definitions.

@VladimirAlexiev can you see now many of your issues this solves? Perhaps you can close this ticket if it solves lots and raise other ones for remaining problems?