[Date Prev][Date Next][Thread Prev][Thread Next][Date Index][Thread Index]

Re: Manifesto



On Mon, 23 Oct 2000, Edward M. Corrado wrote:

> ... if a potential contributor needs to learn
> a whole new program (to them), such as LinuxDoc or DocBook, or jump
> through a number of hoops to submit their documentation, they might just
> decide it is not worth the effort.

I whole-heartedly agree.  (Even though I am in favour of all authors
eventually achieving proficiency in markup skills.  The two views are
neither inconsistent nor mutually incompatible.)

However -- and from a purely practical point of view -- the most useful
HOWTO information always comes from those who have struggled _hard_ to
get something to work; have learned all the ins and outs of so
doing; and have amassed a great deal of understanding of just what needs
to be done, and in what order, and where the tools to do it may be found
-- and want nothing more than to pass on their learning to others.

And THAT is what the LDP requires.

Not, I am afraid, a beautifully marked-up chunk of text.
(Which, incidentally, may take a further six months to produce). 

So my advice to all would-be authors/HOWTO writers is this -- produce
your text; make sure its structure is clear and obvious; have it read
over by a friend or two; if you can't produce it in SGML-tagged format,
then reduce it to flat ASCII from whatever you produced it in; remove
all superfluous blank lines; spell-check it; announce its availability
via this list (or make it available on some web-site or other); request
editorial assistance for its conversion to SGML/any other required 
format; then wait for comments.

If you don't get any comments, either no-one's interested in the topic, 
or no-one's interested in the writing.
If you don't get conversion, then none of the available editors could
find the time/energy (we're all over-extended).

In any case, it's no longer your problem -- let the mandarins deal with
it from there on in.

msw
--
[email protected]


--  
To UNSUBSCRIBE, email to [email protected]
with a subject of "unsubscribe". Trouble? Contact [email protected]