[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message]

Re: A Plea for Schemas

• From: "Simon St.Laurent" <simonstl@s...>
• To: xml-dev@i...
• Date: Mon, 01 Nov 1999 19:59:50 -0500

At 07:35 PM 11/1/99 -0500, David Megginson wrote:
>Paul Prescod <paul@p...> writes:
>
>> Tim Bray wrote:
>> > 
>> > Note "machine-readable" in the sentence above.  At this point in history,
>> > it's the human-readable part of schemas that seem to me to have the
>> > biggest payoffs, because that's what the programmers read before they
>> > write the code that actually does something useful. -Tim
>> 
>> Any programmer that reads the prose but doesn't read the schema is bound
>> to make many avoidable assumptions and mistakes.
>
>Et vice-versa.  The only reason that formal languages are less
>ambiguous than natural ones is that they're not capable of saying much
>in the first place.

That last bit is a beautiful statement that sums it all up, though the
pieces above it both have merit.  

We need a standard way to get to all of that information, both machine- and
human- readable. Right now, all we have is a way to get a formal
description and a bunch of comments, if we're very lucky.

I'm strongly hoping that both the XML Schemas and XML Packaging efforts
give very high priority to human-readable documentation.  I just finished
(yet another) XML book in which I felt every other sentence was "make sure
you document it for _people_, because if you don't, it's just more crap".

Simon St.Laurent
XML: A Primer, 2nd Ed.
Building XML Applications
Inside XML DTDs: Scientific and Technical
Sharing Bandwidth / Cookies
http://www.simonstl.com

xml-dev: A list for W3C XML Developers. To post, mailto:xml-dev@i...
Archived as: http://www.lists.ic.ac.uk/hypermail/xml-dev/ and on CD-ROM/ISBN 981-02-3594-1
To unsubscribe, mailto:majordomo@i... the following message;
unsubscribe xml-dev
To subscribe to the digests, mailto:majordomo@i... the following message;
subscribe xml-dev-digest
List coordinator, Henry Rzepa (mailto:rzepa@i...)

• References:
  • Re: A Plea for Schemas
    • From: Tim Bray <tbray@t...>
  • Re: A Plea for Schemas
    • From: Paul Prescod <paul@p...>
  • Re: A Plea for Schemas
    • From: David Megginson <david@m...>

• Prev by Date: Re: A Plea for Schemas
• Next by Date: re: Re: Undeclared namespace
• Previous by thread: Re: A Plea for Schemas
• Next by thread: RE: A Plea for Schemas
• Index(es):
  • Date
  • Thread