minor updates based on Tom's review of PROV-XML Note
authorStephan Zednik <zednis@rpi.edu>
Thu, 18 Apr 2013 09:00:51 -0600
changeset 6224 7636745d349a
parent 6223 d00d14205f34
child 6225 b64c0dd9f3b7
minor updates based on Tom's review of PROV-XML Note
xml/prov-xml.html
--- a/xml/prov-xml.html	Thu Apr 18 12:07:37 2013 +0200
+++ b/xml/prov-xml.html	Thu Apr 18 09:00:51 2013 -0600
@@ -235,7 +235,7 @@
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-xml-20130430/">PROV-XML</a> (Note),  an XML schema for the PROV data model (this document);</li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-aq-20130430/">PROV-AQ</a> (Note), mechanisms for accessing and querying provenance [[PROV-AQ]]; </li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dictionary-20130430/">PROV-DICTIONARY</a> (Note) introduces a specific type of collection, consisting of key-entity pairs [[PROV-DICTIONARY]];</li>
-<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dc-20130430/">PROV-DC</a> (Note) provides a mapping between PROV-O and Dublic Core Terms [[PROV-DC]];</li>
+<li> <a href="http://www.w3.org/TR/2013/NOTE-prov-dc-20130430/">PROV-DC</a> (Note) provides a mapping between PROV-O and Dublin Core Terms [[PROV-DC]];</li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-sem-20130430/">PROV-SEM</a> (Note), a declarative specification in terms of first-order logic of the PROV data model [[PROV-SEM]];</li>
 <li> <a href="http://www.w3.org/TR/2013/NOTE-prov-links-20130430/">PROV-LINKS</a> (Note) introduces a mechanism to link across bundles [[PROV-LINKS]].</li>
 </ul>
@@ -306,8 +306,8 @@
 
 <section id="schema-modularization">
 <h3>Schema Modularization</h3>
-<p>The PROV-XML schema have been modularized so that xml-elements denoting terms defined in Working Group Notes are defined in separate extension schemas.  All xml-elements denoting terms defined in the PROV-DM are defined in the <b>prov-core.xsd</b> schema and xml-elements denoting terms defined in PROV Working Group Notes are defined in extension schemas (e.g. <b>prov-dictionary.xsd</b>, <b>prov-links.xsd</b>).  The default schema, <b>prov.xsd</b>, imports <b>prov-core.xsd</b> and all extension schemas.  With this modeling all PROV xml-elements, even those denoting terms defined in Notes, are declared from the default schema.  If the user wishes to leverage a schema that does not include xml-elements corresponding to terms from the PROV Notes the user can use schemaLocation to directly reference the core schema.</p>
-<p>The default schema - <b>prov.xsd</b></p>
+<p>The PROV-XML schema have been modularized so that xml-elements denoting terms defined in Working Group Notes are defined in separate extension schemas.  All xml-elements denoting terms defined in the PROV-DM are defined in the <b><a href="http://www.w3.org/ns/prov-core.xsd">http://www.w3.org/ns/prov-core.xsd</a></b> schema and xml-elements denoting terms defined in PROV Working Group Notes are defined in extension schemas (e.g. <b><a href="http://www.w3.org/ns/prov-dictionary.xsd">http://www.w3.org/ns/prov-dictionary.xsd</a></b>, <b><a href="http://www.w3.org/ns/prov-links.xsd">http://www.w3.org/ns/prov-links.xsd</a></b>).  The default schema, <b><a href="http://www.w3.org/ns/prov.xsd">http://www.w3.org/ns/prov.xsd</a></b>, imports <b><a href="http://www.w3.org/ns/prov-core.xsd">http://www.w3.org/ns/prov-core.xsd</a></b> and all extension schemas.  With this modeling all PROV xml-elements, even those denoting terms defined in Notes, are declared from the default schema.  If the user wishes to leverage a schema that does not include xml-elements corresponding to terms from the PROV Notes the user can use schemaLocation to directly reference the core schema.</p>
+<p>The default schema - <b><a href="http://www.w3.org/ns/prov.xsd">http://www.w3.org/ns/prov.xsd</a></b></p>
 <pre>
 &lt;?xml version="1.0" encoding="utf-8"?&gt;
 &lt;xs:schema targetNamespace="http://www.w3.org/ns/prov#"
@@ -322,11 +322,11 @@
 
 &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 xml-elements to the list of valid PROV xml-elements in a bundle or document.</p>
+<p>Extension schemas import the <b><a href="http://www.w3.org/ns/prov-core.xsd">http://www.w3.org/ns/prov-core.xsd</a></b> schema and make use of a substitution group on the <code>prov:internalElement</code> to add extension-defined xml-elements to the list of valid PROV xml-elements in a bundle or document.</p>
 <div class="note">
 <p>This schema design leveraging substitutionGroups on an abstract xml-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>
+<p>The <b><a href="http://www.w3.org/ns/prov-links.xsd">http://www.w3.org/ns/prov-links.xsd</a></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"
@@ -1127,7 +1127,7 @@
 <section id="component2"> 
 <h3>Component 2: Derivations</h3>
 
-<p>The second component of PROV-DM is concerned with: <a title="derivation" href="#term-Derivation">derivations</a> of <a title="entity">entities</a> from other entities and derivation subtypes WasRevisionOf (<a href="#term-Revision">Revision</a>), WasQuotedFrom (<a href="#term-Quotation">Quotation</a>), and HasPrimarySource (<a href="#term-PrimarySource">Primary Source</a>).</p>
+<p>The second component of PROV-DM is concerned with: <a title="derivation" href="#term-Derivation">derivations</a> of <a title="entity">entities</a> from other entities and derivation subtypes<a href="#term-Revision">Revision</a>, <a href="#term-Quotation">Quotation</a>, and <a href="#term-PrimarySource">Primary Source</a>.</p>
 
 <section id="term-Derivation">
 <h4>Derivation</h4>
@@ -1309,8 +1309,7 @@
 <section id="component3">
 <h3>Component 3: Agents, Responsibility, and Influence</h3>
 
-<p>The third component of PROV-DM is concerned with <a title="agent">agents</a> and the relations WasAttributedTo
-(<a href="#term-Attribution">Attribution</a>), WasAssociatedWith (<a href="#term-Association">Association</a>), ActedOnBehalfOf (<a href="#term-Delegation">Delegation</a>), relating agents to entities, activities, and agents, respectively.</p>
+<p>The third component of PROV-DM is concerned with <a title="agent">agents</a> and the relations <a href="#term-Attribution">Attribution</a>, <a href="#term-Association">Association</a>, and <a href="#term-Delegation">Delegation</a>, relating agents to entities, activities, and agents, respectively.</p>
 
 <section id="term-Agent">
 <h4>Agent</h4>
@@ -1840,8 +1839,8 @@
 
 <section id="component5"> 
 <h3>Component 5: Alternate Entities</h3>
-<p>The fifth component of PROV-DM is concerned with
-relations SpecializationOf (<a href="#term-Specialization">Specialization</a>) and AlternateOf (<a href="#term-Alternate">Alternate</a>) between entities.</p>
+<p>The fifth component of PROV-DM is concerned with the
+relations <a href="#term-Specialization">Specialization</a> and <a href="#term-Alternate">Alternate</a>, relating entities to entities.</p>
 
 <section id="term-Specialization">
 <h4>Specialization</h4>
@@ -2421,6 +2420,9 @@
 <section>
 <h3>Change Log Since WD Working Draft 12 March 2013</h3>
 <ul>
+<li>Updated Component section descriptive text</li>
+<li>Added links to schemas in Schema Modularization section</li>
+<li>Fixed typo in Status of this Document section</li>
 <li>Added Identifier Conventions section</li>
 <li>Updated naming conventions to clarify distinction between PROV elements, attributes, and types and XML elements, attributes, and types.</li>
 <li>Added links to PROV-DM term/concepts in Table 1.</li>