xml-dev - Re: Colonialism, SAX, Java, and Namespaces

[Avi Rappoport <avirr@LanMinds.Com>]

At 12:56 PM -0500 2/5/99, Simon St.Laurent wrote:
> Precisely.  Taking the time and making the effort to ensure that
> specifications are clear - and not just to a small community of experts -
> means a lot less need for repeated explanation afterward.  It makes a
> specification more inclusive, avoiding the need for debates over who is
> worthy of reading the spec.

I agree, and have found that the best way to be truly clear is to 
provide as many examples as possible.  The one caveat is that almost 
every beginner will follow those examples slavishly, so they'd better 
be well-designed and applicable to a wide variety of situations.

There's a nice opportunity for an "XML Namespaces By Example" book 
and/or site, which could provide an excellent supplement to the spec. 
If, in fact, the examples really do follow the spec...

Perhaps the best way to get started is to encourage people to post 
their early designs and drafts to the list for constructive comments. 
That way, those of us who are having a hard time grokking the process 
can learn from the public analysis.

Avi
________________________________________________________________
Avi Rappoport, Web Site Search Tools Maven: <mailto:avirr@lanminds.com>
Guide to Site Indexing and Local Search Engines: <http://www.searchtools.com>

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/ and on CD-ROM/ISBN 981-02-3594-1
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)