updates based on Paul's feedback
authorStephan Zednik <zednis@rpi.edu>
Tue, 16 Apr 2013 10:38:28 -0600
changeset 6186 17137c797f09
parent 6185 88dd5904b0e9
child 6187 b425d0f7cb5f
updates based on Paul's feedback
xml/prov-xml.html
--- a/xml/prov-xml.html	Tue Apr 16 09:35:36 2013 -0600
+++ b/xml/prov-xml.html	Tue Apr 16 10:38:28 2013 -0600
@@ -278,13 +278,14 @@
 </ul>
 
 <p>
-This specification goal is to provide a succinct definition of the XML form of PROV-DM, thus, we refer the reader to the PROV-DM to provide overall justification and context to the definitions presented here.  
+<i>This specification's goal is to provide a succinct definition of the XML form of PROV-DM</i>, thus, we refer the reader to the PROV-DM to provide overall justification and context to the definitions presented here.  
 </p>
 
 <section id="prov-namespace">
 <h3>PROV Namespace</h3>
 <p>The PROV namespace is <span class="name">http://www.w3.org/ns/prov#</span>.</p>
-<p> All the concepts, reserved names and attributes introduced in this specification belong to the PROV namespace.</p>
+<p>All the concepts, reserved names and attributes introduced in this specification belong to the PROV namespace.</p>
+<p>The prefix <b>prov</b> is used when referring to the PROV namespace.</p>
 </section> <!-- end prov-namespace -->
 
 <section id="conventions"> 
@@ -310,39 +311,39 @@
 <pre>
 &lt;?xml version="1.0" encoding="utf-8"?&gt;
 &lt;xs:schema targetNamespace="http://www.w3.org/ns/prov#"
-           xmlns:xs="http://www.w3.org/2001/XMLSchema"
-           xmlns:prov="http://www.w3.org/ns/prov#"
-           elementFormDefault="qualified"
-           attributeFormDefault="unqualified"&gt;
-
-	&lt;xs:include schemaLocation="prov-core.xsd"/&gt;
-	&lt;xs:include schemaLocation="prov-dictionary.xsd"/&gt;
-	&lt;xs:include schemaLocation="prov-links.xsd"/&gt;
+    xmlns:xs="http://www.w3.org/2001/XMLSchema"
+    xmlns:prov="http://www.w3.org/ns/prov#"
+    elementFormDefault="qualified"
+    attributeFormDefault="unqualified"&gt;
+    
+  &lt;xs:include schemaLocation="prov-core.xsd"/&gt;
+  &lt;xs:include schemaLocation="prov-dictionary.xsd"/&gt;
+  &lt;xs:include schemaLocation="prov-links.xsd"/&gt;
 
 &lt;/xs:schema&gt;
 </pre>
 <p>Extension schemas import the <b>prov-core.xsd</b> schema and make use of a substitution group on the <code>prov:internalElement</code> to add extension-defined elements to the list of valid PROV elements in a bundle or document.</p>
 <div class="note">
-<p>This schema design leveraging substitutionGroups on an abstract element may result in sub-optimal binding classes being generated by OXM frameworks such as JAXB, JiBX, etc. See the PROV FAQ entry at <a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ#How_should_I_generate_JAXB_classes_from_the_PROV-XML_schemas.3F">How should I generate JAXB classes from the PROV-XML schemas?</a> for a JAXB-specific discussion on using OXM technologies with the PROV schemas.</p>
+<p>This schema design leveraging substitutionGroups on an abstract element may result in sub-optimal binding classes being generated by Object-to-XML frameworks such as JAXB, JiBX, etc. See the PROV FAQ entry at <a href="http://www.w3.org/2001/sw/wiki/PROV-FAQ#How_should_I_generate_JAXB_classes_from_the_PROV-XML_schemas.3F">How should I generate JAXB classes from the PROV-XML schemas?</a> for a JAXB-specific discussion on using OXM technologies with the PROV schemas.</p>
 </div> <!-- end note -->
 <p>The <b>prov-links.xsd</b> extension schema.</p>
 <pre>
 &lt;?xml version="1.0" encoding="UTF-8"?&gt;
 &lt;xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
-	targetNamespace="http://www.w3.org/ns/prov#" xmlns:prov="http://www.w3.org/ns/prov#"
-	elementFormDefault="qualified"&gt;
-	
-	&lt;xs:include schemaLocation="prov-core.xsd" /&gt;
+    targetNamespace="http://www.w3.org/ns/prov#" xmlns:prov="http://www.w3.org/ns/prov#"
+    elementFormDefault="qualified"&gt;
 	
-	&lt;xs:complexType name="Mention"&gt;
-		&lt;xs:sequence&gt;
-			&lt;xs:element name="specificEntity" type="prov:IDRef" /&gt;
-			&lt;xs:element name="generalEntity" type="prov:IDRef" /&gt;
-			&lt;xs:element name="bundle" type="prov:IDRef" /&gt;
-		&lt;/xs:sequence&gt;
-	&lt;/xs:complexType&gt;
+  &lt;xs:include schemaLocation="prov-core.xsd" /&gt;
 	
-	&lt;xs:element name="mentionOf" type="prov:Mention" substitutionGroup="prov:internalElement" /&gt;
+  &lt;xs:complexType name="Mention"&gt;
+    &lt;xs:sequence&gt;
+      &lt;xs:element name="specificEntity" type="prov:IDRef" /&gt;
+      &lt;xs:element name="generalEntity" type="prov:IDRef" /&gt;
+      &lt;xs:element name="bundle" type="prov:IDRef" /&gt;
+    &lt;/xs:sequence&gt;
+  &lt;/xs:complexType&gt;
+  
+  &lt;xs:element name="mentionOf" type="prov:Mention" substitutionGroup="prov:internalElement" /&gt;
 	
 &lt;/xs:schema&gt;
 </pre>
@@ -359,6 +360,8 @@
 <section id="elements-vs-attributes">
 <h3>Elements vs. Attributes</h3>
 
+<p>The PROV Notation (PROV-N) is a serialization of the PROV Data Model described in [[PROV-N]].  Examples in the [[PROV-DM]] document are encoded using PROV-N.  Because of the heavy use of PROV-N syntax in [[PROV-DM]], the PROV-XML editors feel it is important to present a comparison of the PROV-N and PROV-XML syntaxes and justifications behind the select syntax decisions in PROV-XML.</p>
+
 <p>The general PROV-N syntax patterns for expressing provenance
 concepts are:
 </p>
@@ -2399,7 +2402,8 @@
 <section>
 <h3>Change Log Since WD Working Draft 12 March 2013</h3>
 <ul>
-<li>Updated inline schema</li>
+<li>Added prefix conventions section to </li>
+<li>Removed inline schema, added links to published schemas</li>
 <li>Updated BundleConstructor and Document sections to reflect changes to schema</li>
 <li>Added Other section for prov:other element and type</li>
 <li>Updated the Status of this Document section</li>