Re: [SLUG] Tools for documentation.

[Jamie Honan <jhonan@nospam.optushome.com.au>]

My 2c is not to worry about format at first.

The single most important thing about writing is the message you
want to convey, what you want to say and how to say it.

If you just write what you want in ordinary text, using your preferred
editor, without considering markup or how your document looks, you
will do a better job of communicating.

It is then not too hard to markup afterwards, often using the
same text editor.

An example of a system that takes ordinary text and puts it
into html is txt2html (search freshmeat). This perl script
guesses headings, lists and preformatted areas. html2ps
is another script that may be useful. These won't do as good
a job as LaTex or DocBook, but have a much smaller learning curve
and may do the job for simple projects.

I would try to avoid systems that place your document into
proprietary formats (especially non ascii ones). You always
want to be able to edit your primary document with an
ordinary text editor.

For that reason, LaTex, DocBook, Lout, groff or even html
are preferrable (if you can).

Jamie

--
SLUG - Sydney Linux Users Group Mailing List - http://www.slug.org.au
To unsubscribe send email to slug-request@nospam.slug.org.au with
unsubscribe in the text