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

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

  • From: tpassin@h...
  • To: xml-dev@l...
  • Date: Thu, 12 Oct 2000 09:31:06 -0400

rewrite write
Linda van den Brink wrote -

> > Readers are invited to submit comments on specs, but readers are not
> > invited to participate in the development of specs as
> > participants.  I'd
> > suggest that this barrier doesn't exactly encourage readers
> > to take on copy
> > editing W3C specs as a gift to an organization that isn't
> > exactly inclusive.
>
> True. And another reason I just thought of out why it wouldn't work is,
that
> a reader who has difficulty understanding a section of a w3c spec would
also
> have difficulty suggesting a rewrite. Whereas a tech writer, who is inside
> the organization, would presumably have good communication lines to the
> editors of specs and could ask them 'what is meant here' and THEN come up
> with a good rewrite.
>
It could actually be useful - you would rewrite write the parts you
inderstand as clearly as possible and the part you didn't understand, you
would write according to your best understanding.  Also remark that you
weren't sure your version was correct. The spec editor would be impelled to
consider reworking the original since there would be a clear but wrong
version in front of his(/her) eyes.

A lot of the difficulties are at a very mundane level.  Too many
run-together clauses, too many chains of qualifiers, too many exceptions,
make it hard for anyone to puzzle out the intended meaning unless you
already know what it is.  These kinds of things can be helped by a person
who doesn't know the material very well.

Tom Passin


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.