General discussion of OpenCATS

Moderators: RussH, cptr13

Forum rules: Just remember to play nicely once you walk through the door. You can disagree with us, or any other commenters in this forum, but keep comments directed to the topic at hand.
User avatar
By andyf
#1633
Hi folks,

I'm new here. I've just set up and am starting to use OpenCATS, but I'm really a documentation guy. Can I lend a hand here? I would like to put together a manual (DocBook to PDF, built from XML source in subversion, say?) if I can get some technical partnership.

Cheers,

Andy
User avatar
By andyf
#1634
OK, so I've started work on a manual. You can see the latest skeleton draft built at http://ocdocs.treffle.com.
I wanted to attach it, but the upload refused to accept PDF. Features of this draft:

- Fully developed outline, needs comments/feedback. See the table of contents.
- Built from DocBook XML source, with graphics in graphviz/dot.
- Life cycle discussion adapted from mabdalla's 2008 forum post
- Complete skeleton and working build apparatus. (Built from checked-in XML source using make/dot/xsltproc/fop.)

Next steps:

- Tune the layout and typography, especially the cover and the heading styles (currently everything is default values)
- Adapt material from the "CATS in 5 minutes" quick guide

Beyond that, I could sure use some technical partners to help generate content... Please PM me at the forum if you can help!

Andy
User avatar
By RussH
#1644
Hi Andy,

I've changed the upload config - can you retry attaching the user Guide?

This is the "import from resume"[…]

EMAIL CONFIGURATION

Hi, the email configuration (including different[…]

as the title says...

It's essential to keep these synchronized to ensur[…]