Lists Home |
Date Index |
- From: Avi Rappoport <avirr@LanMinds.Com>
- To: XML-Dev Mailing list <email@example.com>
- Date: Fri, 5 Feb 1999 10:30:09 -0800
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 Rappoport, Web Site Search Tools Maven: <mailto:firstname.lastname@example.org>
Guide to Site Indexing and Local Search Engines: <http://www.searchtools.com>
xml-dev: A list for W3C XML Developers. To post, mailto:email@example.com
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ and on CD-ROM/ISBN 981-02-3594-1
To (un)subscribe, mailto:firstname.lastname@example.org the following message;
To subscribe to the digests, mailto:email@example.com the following message;
List coordinator, Henry Rzepa (mailto:firstname.lastname@example.org)