Re: Multiple XML schema files for a common target namespace (PROV-ISSUE-608)

Thanks Stephan. Is the document ready or review?

Professor Luc Moreau
Electronics and Computer Science
University of Southampton 
Southampton SO17 1BJ
United Kingdom

On 14 Feb 2013, at 00:21, "Stephan Zednik" <zednis@rpi.edu> wrote:

> Hi Luc,
> 
> Because time is running down on getting the PROV-XML Note ready for the next release I went ahead and updated the editors draft with the discussed changes.
> 
> https://dvcs.w3.org/hg/prov/raw-file/default/xml/prov-xml.html

> 
> I have added sections to the design patterns section concerning the schema modularity and the conventions on type information.
> 
> https://dvcs.w3.org/hg/prov/raw-file/default/xml/prov-xml.html#schema-modularization

> https://dvcs.w3.org/hg/prov/raw-file/default/xml/prov-xml.html#type-conventions
> 
> I have also update the Bundles section with the design that Stian and I have most recently been discussing and which I think will be satisfactory to you.  I did rename the element to bundleContent as Stian suggested because it reads much better than bundleConstructor.
> 
> https://dvcs.w3.org/hg/prov/raw-file/default/xml/prov-xml.html#component4

> 
> Please let me know if you would like me to change anything.  I tried to make the text in the bundle section clear but it's wording may not align with your interpretation.
> 
> I have also made several other update to the document including updating the SOTD section, please refer to the Change Log section at the bottom for a summary of changes.
> 
> --Stephan
> 
> On Feb 13, 2013, at 9:43 AM, Stephan Zednik <zednis@rpi.edu> wrote:
> 
>> How about the following changes? More discussion of the bundleConstructor referencing element name below.
>> 
>> <xs:complexType name="Bundle">
>>   <xs:complexContent>
>>     <xs:extension base="prov:Entity">
>>     </xs:extension>
>>   </xs:complexContent>
>> </xs:complexType>
>> 
>> <xs:complexType name="BundleConstructor">
>>    <xs:sequence maxOccurs="unbounded">
>>        <xs:group ref="prov:documentElements"/>
>>        <xs:any namespace="##other" processContents="lax" minOccurs="0" maxOccurs="unbounded"/>
>>    </xs:sequence>
>>    <xs:attribute ref="prov:id"/>
>> </xs:complexType>
>> 
>> <xs:element name="document" type="prov:Document" />
>> <xs:complexType name="Document">
>>   <xs:sequence maxOccurs="unbounded">
>>       <xs:group ref="prov:documentElements" minOccurs="0"/>
>>        <xs:element name="bundleConstructor" type="prov:BundleConstructor" minOccurs="0"/>
>>       <xs:any namespace="##other" processContents="lax" minOccurs="0" />
>>   </xs:sequence>
>> </xs:complexType>
>> 
>> The group prov:documentElements does not contain a reference to prov:BundleConstructor.
>> 
>> 
>> On Feb 13, 2013, at 2:50 AM, Stian Soiland-Reyes <soiland-reyes@cs.manchester.ac.uk> wrote:
>> 
>>> On Wed, Feb 13, 2013 at 8:19 AM, Luc Moreau <l.moreau@ecs.soton.ac.uk> wrote:
>>>> In section 5.4.2,
>>>> http://www.w3.org/TR/2012/CR-prov-dm-20121211/#term-bundle-entity, you will
>>>> see the sentence:
>>>> 
>>>> A bundle description is of the form entity(id, [ prov:type='prov:Bundle',
>>>> attr1=val1, ...] )
>>>> 
>>>> I therefore think it would be very confusing to use the term
>>>> bundleDescriptions to refer to the constructor of section 5.4.1
>>> 
>>> Agreed.
>>> 
>>> 
>>>> A bundle constructor ◊ allows the content and the name of a bundle to be specified
>>> 
>>> what about <bundleContent> then?  I think that should make distinction
>>> with <bundle> obvious, more so than the 'constructor' which you would
>>> have to read PROV-DM with a lens to understand.
>>> 
>>> 
>>> Thus in a way everything in PROV-XML is a description, <bundle> is a
>>> bundle description, and <bundleContent> describes the content of the
>>> bundle (ie. further PROV statements).
>> 
>> With the modeling suggestion above I use prov:bundleConstructor, but like Stian I am not a big fan of how it reads in XML.
>> 
>> I like the following (in order of preference):
>> 
>> bundleContent
>> bundleRecords
>> bundleStatements
>> 
>> --Stephan
>> 
>>> 
>>> 
>>> 
>>> -- 
>>> Stian Soiland-Reyes, myGrid team
>>> School of Computer Science
>>> The University of Manchester
>>> 
>>> 
>> 
>> 
>> 
> 

Received on Thursday, 14 February 2013 06:03:15 UTC