more updates to Review Question on additional types.
authorStephan Zednik <zednis@rpi.edu>
Thu, 13 Dec 2012 10:47:00 -0700
changeset 5348 1144785c6a61
parent 5347 e10318b31d7c
child 5349 d43359cada3a
more updates to Review Question on additional types.
xml/prov-xml.html
--- a/xml/prov-xml.html	Thu Dec 13 10:37:47 2012 -0700
+++ b/xml/prov-xml.html	Thu Dec 13 10:47:00 2012 -0700
@@ -251,6 +251,7 @@
 construction of the PROV XML Schema.
 </p>
 
+<section id="design-pattern">
 <h3><i>Salami Slice</i> Design Pattern</h3>
 
 <p>The general design pattern for the XML schema has been
@@ -259,7 +260,9 @@
 elements with distinct types.  This allows the types to be easily
 reusable for domain specific extensions.
 </p>
+</section> <!-- end design-pattern -->
 
+<section id="elements-vs-attributes">
 <h3>Elements vs. Attributes</h3>
 
 <p>The general PROV-N syntax patterns for expressing provenance
@@ -323,9 +326,9 @@
 
 <p>For example, a Quotation is currently expressed in PROV-N as a type
 of Derivation like this:</p>
-<div class="codeexample">
+<pre class="codeexample">
 wasDerivedFrom(a, b, [prov:type='prov:Quotation'])
-</div>
+</pre>
 
 <p>which is transformed to:</p>
 
@@ -337,7 +340,7 @@
 &lt;/prov:wasDerivedFrom&gt;
 </pre>
 
-<p>This proposal would replace that with an explicit <code>prov:wasQuotedFrom</code> element which has type <code>prov:Quotation</code>, which is an extension of <code>prov:Derivation</code>:
+<p>This proposal would replace that with an explicit <code>prov:wasQuotedFrom</code> element (<a href="http://www.w3.org/TR/2012/CR-prov-o-20121211/#wasQuotedFrom">wasQuotedFrom</a> name from [[PROV-O]]) which has type <code>prov:Quotation</code>, which is an extension of <code>prov:Derivation</code>:
 </p>
 <p>Additions to the schema:</p>
 <pre class="codeexample">
@@ -363,12 +366,14 @@
 </p>
 
 </div>
+</section> <!-- end elements-vs-attributes -->
 
+<section id="naming-conventions">
 <h3>Naming Conventions</h3>
 <p>Element names are aligned with [[PROV-N]] record names (e.g. <code>prov:wasGeneratedBy</code>, <code>prov:actedOnBehalfOf</code>) and record parameter roles (e.g. <code>prov:delegate</code>, <code>prov:responsible</code> on a Delegation).  Elements are named in camelCase which also conforms with [[PROV-N]] naming conventions.</p>
 <p>ComplexType names are aligned with [[PROV-DM]] type names (e.g. <code>prov:Generation</code>, <code>prov:Delegation</code>).  ComplexTypes are named in PascalCase which conforms to [[PROV-DM]] naming conventions and differentiates complexTypes from elements in the schema.</p>
 <p>The document root in a PROV-XML serialization is expected to be <code>prov:document</code>.</p>
-
+</section>
 
 </section> <!-- end schema-design -->