OpenACS Documentation. 
by Roberto Mello (rmello@fslc.usu.edu) and the OpenACS team.
------------------------------------------------------------

I am no DocBook expert, so there's most certainly a better way 
to do this, and you're welcome to find out how (just make sure
that when you do find out, you let me know :)) but this is how I
did it.

Writing:
-------

I started in LyX, which does a pretty good job, and then moved
to Emacs with the PSGML mode.

Conversion:
----------
To convert the documentation to HTML, I followed the LDP Author Guide
from www.linuxdoc.org and the ldp.dsl stylesheet distributed with it. 

After adding the appropriate entries to my catalogs, I create one
subdir for each document (written in Article format, book would probably
be good) and ran Jade for each .sgml file from its own directory.

For example, for the AOLserver Simple Install Guide, I created a 
subdirectory called "aolserver" and from within in ran the command:

jade -t sgml -i html -d /usr/lib/sgml/stylesheet/ldp.dsl\#html ../src/simple-aolserver-install.sgml

And that's it.
