- From: Rob Sanderson via GitHub <sysbot+gh@w3.org>
- Date: Tue, 03 Nov 2015 20:42:45 +0000
- To: public-annotation@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 today. My proposal instead is to intentionally mimic the familiar style, but that the process should be manual. -- GitHub Notif of comment by azaroth42 See https://github.com/w3c/web-annotation/issues/97#issuecomment-153481889
Received on Tuesday, 3 November 2015 20:42:47 UTC