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

Improved writing -- who's going to pay for it?

  • From: Joseph Kesselman/Watson/IBM <keshlam@u...>
  • To: xml-dev@l...
  • Date: Tue, 10 Oct 2000 12:26:20 -0400

improved writing skills

>So let's encourage - even demand - the standard writers to improve
>their writing

Remember, standards committees are made up of resources contributed by
member companies. Most companies would rather put manpower/mindpower into
developing the standard itself -- because they need to make sure it's
something they and their customers can live with henceforward -- than into
wordsmithing, and it isn't often that you find both strong  technical
skills and technical-writing skills in the same individual.

I'm sure W3C would _love_ to have someone fund them for some technical
writers who could help spec editors improve the readability of these docs,
and I'm sure most editors would appreciate the assistance.  Nobody writes
poorly deliberately. Specs are and always will be written for the
"experienced practitioner" -- and will tend to be terse as a result  -- but
there's certainly room to improve communication with that community, who
can then explain the implications to the less-experienced folks.

So: I agree with the sentiment, but I don't see anyone putting up the cash
needed to fix it. If you're volunteering to do so, contact the W3C.


[For what it's worth, the DOM spec has gotten some technical-writer review
from time to time, and it's been greatly appreciated. We may not always
agree with the details (I absolutely refuse to replace "can not" with
"cannot", though I'd settle for "can't"), but it's definitely helped flush
out some places where our description was fuzzy or awkward or incomplete.]

______________________________________
Joe Kesselman  / IBM Research


PURCHASE STYLUS STUDIO ONLINE TODAY!

Purchasing Stylus Studio from our online shop is Easy, Secure and Value Priced!

Buy Stylus Studio Now

Download The World's Best XML IDE!

Accelerate XML development with our award-winning XML IDE - Download a free trial today!

Don't miss another message! Subscribe to this list today.
Email
First Name
Last Name
Company
Subscribe in XML format
RSS 2.0
Atom 0.3
 

Stylus Studio has published XML-DEV in RSS and ATOM formats, enabling users to easily subcribe to the list from their preferred news reader application.


Stylus Studio Sponsored Links are added links designed to provide related and additional information to the visitors of this website. they were not included by the author in the initial post. To view the content without the Sponsor Links please click here.

Site Map | Privacy Policy | Terms of Use | Trademarks
Free Stylus Studio XML Training:
W3C Member
Stylus Studio® and DataDirect XQuery ™are products from DataDirect Technologies, is a registered trademark of Progress Software Corporation, in the U.S. and other countries. © 2004-2013 All Rights Reserved.