W3C home > Mailing lists > Public > public-annotation@w3.org > November 2015

Re: [web-annotation] Editorial: Split model into vocab and model+json-ld

From: Rob Sanderson via GitHub <sysbot+gh@w3.org>
Date: Tue, 03 Nov 2015 20:42:45 +0000
To: public-annotation@w3.org
Message-ID: <issue_comment.created-153481889-1446583364-sysbot+gh@w3.org>
The proposal at TPAC was to auto-generate the documentation using the 
ontology plus a tool like [LODE](http://www.essepuntato.it/lode). 
There are several issues with this:
  *  There is a distinction between the terms we define in the 
ontology, and the terms that we use in the model.  This documentation 
should cover both, and the ontology would only cover our own.
  *  The result would still need to be respec'd to ensure presentation
 and process consistency.
  *  It separates concerns of publication of spec documents from 
publication of technical artifacts such as ontologies.  Editors 
(present and future) should not be required to write OWL to update the
 specification, the OWL should be derived from that specification.
  *  Given the above, it's unclear that there would be significant 
savings, nor that the result would be more readable than what we have 

My proposal instead is to intentionally mimic the familiar style, but 
that the process should be manual.

GitHub Notif of comment by azaroth42
Received on Tuesday, 3 November 2015 20:42:47 UTC

This archive was generated by hypermail 2.4.0 : Friday, 17 January 2020 18:54:42 UTC