Documentation - Re: [OT] Too Quiet

[James McDonald]

> * Converting MS Word documents, HTML help files, and SGML source files to
>  XML (almost done with that, actually)
> * Updating the corporate style sheet for product documentation
> * Working on XSLT transforms for said XML-based documentation
> * Learning a new, odious XML editor (I was comfortable with emacs)
> * Integrating document production into our existing build system
> * Figuring out how to shoehorn document rendering into the new build
>  system
I am finding an increasing need to document things in a standard and 
portable manner.

You mention that you are converting documents of varying formats into XML. I 
am curious as to how you are doing this.

Also the 'style sheet' you mention I have long wanted to have some sort of 
template for documentation but can't seem to get started on docbook and the 
like. Is it really as manual as it seems... I was wondering if there are gui 
editors out there to make the markup.

Can anyone recommend a book that can get one off the ground as regards 
documentation.... I'm tired of having several formats. It would be nice to 
have a central base format and then be able to spit out html/pdf/etc as 
needed.