Forum OpenACS Development: Is the documentation in CVS?

Collapse
Posted by Pascal Scheffers on
The ACS documentation is part of the openacs-4 CVS repository. Is
there a similar facility for the OpenACS installation documentation?
I could not find it... It would seem appropriate to me.

Roberto, should we all start using DocBook for the documentation as
you are doing with the install docs? If so, I would find it mighty
convenient if you were to publish the xml or sgml sources somewhere.
That would make copy-catting you that much simpler for me.

Collapse
Posted by Roberto Mello on
The SGML/xml (whatever extension you want to use. right now it's
.sgml) sources are on the SourceForge repository, where they have
always been.

I haven't done anything with the documentation for OpenACS 4 yet,
because a) the kernel wasn't ported, b) only Ben, Don and Dan have
commit access to the openacs-4 tree for now.

Collapse
Posted by Pascal Scheffers on
Durn. I can't find the sgml sources on source forge and a 'find *sgml'
on my local copy doesn't find anything either. I could only find the
htmls in acs3-pg/www/doc/openacs... help me.

Is there a map with the of where all the sources are? The 'what you
need to run...' section only contains the download locations, not
their CVS locations.

Collapse
Posted by Roberto Mello on
Ops! Sorry Pascal. I thought I had committed the source .sgml files but it looks like I didn't. I must have had a brain short-circuit.

Anyhow, I just commited the source files, with an accompanying small README for your reading pleasure :)

Disclaimer: I am no DocBook expert, so if you find a better way to do these things, please let me know.

Collapse
Posted by Don Baccus on
We need to get the documentation moved over to the openacs box, along with the driver, that's for sure ...
Collapse
Posted by Pascal Scheffers on
Roberto,

thanks for the sgml sources. I will look into it and change the 'PG 7.0.3 & 7.1 on the same box' guide to docbook format. I'll keep the same conventions you've been using, for now.

Don, shouldn't the driver be part of the OpenNSD project?

Collapse
Posted by Don Baccus on
OpenNSD's the logical place for the driver once the CVS tree is up and
running properly, but I'll want to keep an up-to-date copy for
downloading here as well.