From: Jim Seymour (jseymourLinxNet.com)
Date: Fri Aug 01 2003 - 18:28:59 CDT

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]

Victor Duchovni <Victor.Duchovnimorganstanley.com> wrote:
>
> On Fri, 1 Aug 2003, Jim Seymour wrote:
>
> > Chateauneuf <dupapeTQMcube.com> wrote:
> > >
> > > Now THIS is sarcastic on my part and more than a tad obnoxious. :-)
> >
> > Yeah, but you allowed as how you might volunteer to help out in the
> > documentation dept. at the end, so all's forgiven ;).
> >
>
> Saying one might volunteer, and actually producing something of useful and
> correct are quite different.
[snip]

Certainly. As my parents used to say "The road to hell is paved with
good intentions." But somebody at least *considering* helping is
better than them not considering it at all, I guess was my point.

>
> It is naive to assume that one can help document a system that one is
> struggling to understand.

Not at all. This is how tech. writers work. They sit down with the
designers/engineers and struggle to understand the thing. It is from
this struggle, most likely due to this struggle, that they're
better-able to explain it to others who wish/need to learn it.

A capable newbie that has newly understood a principle might well be
the *best* person to suggest, or even write, improvements to
documentation. Such a person may know best where the documentation's
weakness' are.

--
Jim Seymour | PGP Public Key available at:
jseymourLinxNet.com | http://www.uk.pgp.net/pgpnet/pks-commands.html
http://jimsun.LinxNet.com |

• Messages sorted by: [ date ] [ thread ] [ subject ] [ author ]