xml-dev - Re: extensibility in XSchema?

[Chris Maden <crism@oreilly.com>]

[Simon St.Laurent]
> This nightmare is precisely what we're trying to avoid.  Comments
> are a weak and downright bad means of providing anything more than
> the simplest supporting information.  XSchema is definitely an
> attempt to address this, and I hope we meet your expectations.
> Please tell us if we don't.

There are two simple ways to do this.

One is based on namespaces, and is a sort of literate programming:

<?xml version="1.0"?>
<?xml:namespace ns="http://www.purl.org/NET/XSchema" prefix="xsc"?>

<xsc:XSchema>
  <xsc:ElementDecl xsc:name="species">
    <reference>
      <purpose>
        <para>The <element>species</element> element should contain
the latinate name of the organism or group of organisms.</para>
      </purpose>
      <example><![CDATA[
        <species>Homo sapiens</species>
        <species>Gorilla gorilla</species>
      ]]></example>
    </reference>
    <xsc:PCData>
  </xsc:Element>
</xsc:XSchema>

The XSchema processor should ignore elements not in its namespace, but
a stylesheet could format the reference sections and do something
intelligent with the structure definitions.

The other option would be for XSchema to standardize some sort of
documentation elements, similar to what's outlined above, or similar
to the DocBook reference pages.

-Chris
-- 
<!NOTATION SGML.Geek PUBLIC "-//Anonymous//NOTATION SGML Geek//EN">
<!ENTITY crism PUBLIC "-//O'Reilly//NONSGML Christopher R. Maden//EN"
"<URL>http://www.oreilly.com/people/staff/crism/ <TEL>+1.617.499.7487
<USMAIL>90 Sherman Street, Cambridge, MA 02140 USA" NDATA SGML.Geek>

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@ic.ac.uk
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/
To (un)subscribe, mailto:majordomo@ic.ac.uk the following message;
(un)subscribe xml-dev
To subscribe to the digests, mailto:majordomo@ic.ac.uk the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@ic.ac.uk)