[XML-DEV Mailing List Archive Home] [By Thread] [By Date] [Recent Entries] [Reply To This Message] Re: "Clean Specs"
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.... Cheers, E. -- <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 www.isogen.com </Address> 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 (un)subscribe, mailto:majordomo@i... the following message; (un)subscribe xml-dev To subscribe to the digests, mailto:majordomo@i... the following message; subscribe xml-dev-digest List coordinator, Henry Rzepa (mailto:rzepa@i...)
|
PURCHASE STYLUS STUDIO ONLINE TODAY!Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced! Download The World's Best XML IDE!Accelerate XML development with our award-winning XML IDE - Download a free trial today! Subscribe in XML format
|