OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help



   Re: "Clean Specs"

[ Lists Home | Date Index | Thread Index ]
  • From: "W. Eliot Kimber" <eliot@dns.isogen.com>
  • To: XML-Dev Mailing list <xml-dev@ic.ac.uk>
  • Date: Sun, 07 Feb 1999 17:46:51 -0600

At 06:34 PM 2/7/99 -0500, Murray Maloney wrote:
> A professional technical writer was hired
>by W3C for the HTML 4.0 specification.

Didn't know that--puts the lie to what I just posted....

>The XML WG did have at least one professional writer and one 
>professional editor on board, and many of those who were not
>professional writers/editors could not fairly be categorized 
>as amateurs given their academic and professional histories.
>In my experience as a technical writer, I have discovered that
>the act of explaining the application of a technical design
>can, in many cases, lay bare its flaws. Cooperation between 
>writers and designers often results in designs that take the 
>end-user into account.

I agree--in writing my (as yet unfinished) book on HyTime
(www.drmacro.com/bookrev) I uncovered numerous problems with the original
standard, which helped tremendously during the writing of the 2nd edition
of the standard.  While reference implementations are always good,
"reference tutorials" are at least as valuable.  It would be nice if we
always had enough resources and/or time to write the spec and the tutorial
in parallel. Of course, often the person writing the spec is also the one
to write the tutorial and there's only so many hours in a day....


<Address HyTime=bibloc>
W. Eliot Kimber, Senior Consulting SGML Engineer
ISOGEN International Corp.
2200 N. Lamar St., Suite 230, Dallas, TX 75202.  214.953.0004

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)


News | XML in Industry | Calendar | XML Registry
Marketplace | Resources | MyXML.org | Sponsors | Privacy Statement

Copyright 2001 XML.org. This site is hosted by OASIS