From the editors

SIOC

Stian: I tried using specgen, and one of the problems is that there are so many forks. I tried https://github.com/zazi/specgen which only outputted 3 properties or so from our OWL. The other forks seemed to fail in various ways, but I did not have time to try it properly.

One thing you have to be careful about if expressing the specification
directly in HTML+RDFa (and generating RDF/XML from that): it is possible to create RDFa documents where the human
readable text does not match RDFa statements.
- e.g., if one copy-pastes an HTML snippet to create a new class or
property, changes the name visible in HTML but forgets to update the
URI.

It's not the most sophisticated ontology documentation tool around,
but it kinda sorta works. It could do with re-writing, but we've never
really got clear on the requirements. Perhaps the spec should be
maintained in HTML+RDFa, for example, with the RDF/XML view (and
internal cross-links, annotations etc) mechnically generated?

I like that our html output explains domain/range like this,

'Domain: having this property implies being a Person
Range: every value of this property is a Thing'

OPMV

BTW, the cool thing about the OPMV documentation (as well as the Provenance
Vocabulary documentation [1] which served as a template for the OPMV doc) is,
that it embeds the whole vocabulary definition as RDFa in the HTML. Actually,
for Provenance Vocabulary it's the main representation from which we generate
representations in other formats such as RDF/XML. However, creating the HTML
(and the embedded RDFa) was a manual effort.

semweb/lod list

Yes, see TopBraid Composer, http://topquadrant.com/. Any model can be exported to a set of HTML files wit class and property browsers.

OOR list

SPECGen Version 6

Protege list

Joshua Taylor: Have you had a look at OWLDoc? http://code.google.com/p/co-ode-owl-plugins/wiki/OWLDoc The resulting documentation has IMO, a more javadoc-ish feel to it than those examples, though I'm not sure what you can get in terms of free form prose aside from what you put in with rdf annotations.