search

solid / vocab

Solid Vocabularies
https://solid.github.io/vocab/
42 stars 14 forks source link

Define Solid vocabulary #90

Open RubenVerborgh opened 5 years ago

csarven commented 4 years ago

What do you mean by "add"?

http://www.w3.org/ns/solid/terms can be referred from "Namespaces". See https://github.com/solid/specification/pull/83 .

We can describe and exemplify some aspects of the vocab without defining anything.

csarven commented 4 years ago

I was reserving the term "defining" to http://www.w3.org/ns/solid/terms . The vocabulary can be described in its own document similar to https://www.w3.org/TR/annotation-vocab/ or https://www.w3.org/TR/activitystreams-vocabulary/ . It should not go into The Solid Ecosystem document.

csarven commented 4 years ago

Sure, happy to work on this. We can publish that document in HTML(+RDFa) from http://www.w3.org/ns/solid/terms in addition to the current Turtle.

pmcb55 commented 4 years ago

Just a question @csarven: I've been using Widoco (https://github.com/dgarijo/Widoco) to auto-generate really nicely formatted HTML documentation directly from the vocab RDF itself for vocabs I create myself. Are you familiar with that tool? I don't know if Widoco generates RDFa within that HTML too, but it would be really cool if we could generate lovely documentation like https://www.w3.org/TR/annotation-vocab/ or https://www.w3.org/TR/activitystreams-vocabulary/ automatically from the RDF itself without doing any work at all...?

csarven commented 4 years ago

If source is authored in HTML+RDFa eg. same as the process that will be taken for https://github.com/solid/specification/issues/6 , other serializations can be generated. I think that is the most efficient and flexible way of doing it. But I understand that some have their heart on writing vocabs in Turtle :)