atom bind question - 'artifact' and 'content'

[Kurt T Stam <kstam@redhat.com>]

• Only the complete Atom entry representation also contains a foreign markup section describing a structured extension element called s-ramp:artifact. This extension contains a complete S-RAMP XSD schema compliant instance document representing the S-RAMP artifact object.

In atom bind document, example 2 we specify the 'Full Artifact Entry':

<?xml version="1.0" encoding="UTF-8"?>
<entry xmlns="”http://www.w3.org/2005/Atom”" xmlns:s-ramp="”http://s-ramp.org/xmlns/2010/s-ramp”"
    xmlns:xlink="http://www.w3.org/1999/xlink">
    <id>urn:uuid:aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a</id>
    <updated>2009-05-26T13:13:55.013+02:00</updated>
    <title type="“text”">accountingTypes.xsd</title>
    <published>2009-05-26T13:13:55.013+02:00</published>
    <author>
        <name>Bellwood</name>
    </author>
    <contributor>
        <name>Pospisil</name>
    </contributor>
    <summary type="text">accountingTypes.xsd schema document</summary>
    <content type="application/xml;charset=utf-8"
        src=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument/">http://example.org/s-ramp/xsd/XsdDocument/
aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a/media" />
    <link type="application/atom+xml;type=entry" rel="self"
        href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument/">http://example.org/s-ramp/xsd/XsdDocument/
aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a”/>
<link type="
        application="application" / atom="atom" + xml="xml" ; type="entry" "
        rel="edit-media"
        href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument/">http://example.org/s-ramp/xsd/XsdDocument/
aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a/media" />
    <link type="application/atom+xml;type=entry" rel="edit"
        href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a”">http://example.org/s-ramp/xsd/XsdDocument/aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a” />;
<category term="XsdDocument="XsdDocument" " label="XML Schema"
        scheme="urn:x-s-ramp:2010:type” />
<s-ramp:artifact xsi:schemaLocation="
        http:="http:" / s-ramp.org="s-ramp.org" / xmlns="xmlns" / s-ramp="s-ramp"
        http:="http:" / s-ramp.org="s-ramp.org" / specification="specification" /
        schemas="schemas" / xsdmodel.xsd="xsdmodel.xsd" "
        xmlns:s-ramp="http://s-ramp.org/xmlns/2010/s-ramp" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
        <s-ramp:XsdDocument name="”accountingTypes.xsd”"
            description="”accountingTypes.xsd”" createdBy="Bellwood" version="1.0"
            uuid="aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6a" createdTimestamp="2009-05-26T13:13:55.013+02:00"
            lastModifiedTimestamp="2009-06-26T13:13:55.013+02:00" lastModifiedBy="Pospisil"
            contentEncoding="UTF-8" contentType="“application/xml”" contentSize="4096">
            <s-ramp:classifiedBy>
                http://example.org/ontologies/accounting.owl/accounts
            </s-ramp:classifiedBy>
            <!-- Example of the “importedXsds” Derived relationship -->
            <s-ramp:importedXsds>
                <s-ramp:target xlink:href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument">http://example.org/s-ramp/xsd/XsdDocument" /
                    aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b="aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b" ”>
                    aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b
            </s-ramp:target>
            </s-ramp:importedXsds>
            <s-ramp:relationship>
                <s-ramp:relationshipType>similarXsds</s-ramp:relationshipType>
                <s-ramp:relationshipTarget>
                    <s-ramp:target xlink:href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument">http://example.org/s-ramp/xsd/XsdDocument" /
                        aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b="aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b" ”>
                        aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6b
          </s-ramp:target>
                </s-ramp:relationshipTarget>
                <s-ramp:relationshipTarget>
                    <s-ramp:target xlink:href=""moz-txt-link-freetext" href="http://example.org/s-ramp/xsd/XsdDocument">http://example.org/s-ramp/xsd/XsdDocument" /
                        aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6c="aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6c" ”>
                        aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaa6c
          </s-ramp:target>
                </s-ramp:relationshipTarget>
            </s-ramp:relationship>
            <s-ramp:property>
                <propertyName>myPropertyName</propertyName>
                <propertyValue>myPropertyValue</propertyValue>
            </s-ramp:property>
        </s-ramp:XsdDocument>
        <s-ramp:artifact />
</entry>

Wouldn't it make more sense to use the 'content' element (so we don't need to use a structured extension element). For example, see the section in red:

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<atom:entry xmlns:ns2="http://www.w3.org/2005/Atom">
    <ns2:title>PO.xsd</ns2:title>
    <ns2:link href="" class="moz-txt-link-rfc2396E" href="http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/media">"http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/media"type="application/atom+xml;charset=&quot;utf-8&quot;"/>
    <ns2:link href="" class="moz-txt-link-rfc2396E" href="http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509">"http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509" rel="self" type="application/atom+xml;type=&quot;entry&quot;"/>
    <ns2:link href="" class="moz-txt-link-rfc2396E" href="http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/edit-media">"http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/edit-media" rel="edit-media" type="application/atom+xml;type=&quot;entry&quot;"/>
    <ns2:link href="" class="moz-txt-link-rfc2396E" href="http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/edit">"http://localhost:8080/changeit/s-ramp/xsd/XsdDocument/58fb40be-f1e4-419a-8b94-87a90435c509/edit" rel="edit" type="application/atom+xml;type=&quot;entry&quot;"/>
    <ns2:category label="XML Schema" scheme="x-s-ramp:2010:type" term="XsdDocument"/>
    <ns2:updated>2012-05-02T19:17:07.075-04:00</ns2:updated>
    <ns2:id>58fb40be-f1e4-419a-8b94-87a90435c509</ns2:id>
    <ns2:published>2012-05-02T19:17:07.075-04:00</ns2:published>
    <ns2:author>
        <ns2:name>&lt;modeshape-worker&gt;</ns2:name>
    </ns2:author>
    <ns2:content>
        <s-ramp:artifact xmlns:atom="http://www.w3.org/2005/Atom" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:s-ramp="http://s-ramp.org/xmlns/2010/s-ramp">
            <s-ramp:XsdDocument contentEncoding="UTF-8" contentSize="2376" contentType="application/xsd" createdBy="&lt;modeshape-worker&gt;" createdTimestamp="2012-05-02T19:17:07.075-04:00" description="Purchase order schema for Example.com.
     Copyright 2000 Example.com. All rights reserved." lastModifiedBy="&lt;modeshape-worker&gt;" lastModifiedTimestamp="2012-05-02T19:17:07.075-04:00" name="PO.xsd" uuid="58fb40be-f1e4-419a-8b94-87a90435c509" version="1.0"/>
        </s-ramp:artifact>
    </ns2:content>
    <ns2:summary>Purchase order schema for Example.com.
     Copyright 2000 Example.com. All rights reserved.</ns2:summary>
</atom:entry>

Love to hear your opinion on this.

Thx,

--Kurt