--- 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>
<?xml version="1.0" encoding="utf-8"?>
<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">
-
- <xs:include schemaLocation="prov-core.xsd"/>
- <xs:include schemaLocation="prov-dictionary.xsd"/>
- <xs:include schemaLocation="prov-links.xsd"/>
+ xmlns:xs="http://www.w3.org/2001/XMLSchema"
+ xmlns:prov="http://www.w3.org/ns/prov#"
+ elementFormDefault="qualified"
+ attributeFormDefault="unqualified">
+
+ <xs:include schemaLocation="prov-core.xsd"/>
+ <xs:include schemaLocation="prov-dictionary.xsd"/>
+ <xs:include schemaLocation="prov-links.xsd"/>
</xs:schema>
</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>
<?xml version="1.0" encoding="UTF-8"?>
<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">
-
- <xs:include schemaLocation="prov-core.xsd" />
+ targetNamespace="http://www.w3.org/ns/prov#" xmlns:prov="http://www.w3.org/ns/prov#"
+ elementFormDefault="qualified">
- <xs:complexType name="Mention">
- <xs:sequence>
- <xs:element name="specificEntity" type="prov:IDRef" />
- <xs:element name="generalEntity" type="prov:IDRef" />
- <xs:element name="bundle" type="prov:IDRef" />
- </xs:sequence>
- </xs:complexType>
+ <xs:include schemaLocation="prov-core.xsd" />
- <xs:element name="mentionOf" type="prov:Mention" substitutionGroup="prov:internalElement" />
+ <xs:complexType name="Mention">
+ <xs:sequence>
+ <xs:element name="specificEntity" type="prov:IDRef" />
+ <xs:element name="generalEntity" type="prov:IDRef" />
+ <xs:element name="bundle" type="prov:IDRef" />
+ </xs:sequence>
+ </xs:complexType>
+
+ <xs:element name="mentionOf" type="prov:Mention" substitutionGroup="prov:internalElement" />
</xs:schema>
</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>