in last 10 minutes
Writing Documentation for OpenACS
Getting started on documentationdocumentation starter guide this is where I would start.
Getting startedGo to /packages/acs-core-docs/www/doc/xml and type make then you troubleshoot (5-0 may now be at /packages/acs-core-docs/www/xml )
Things to ignore
xmlNanoHTTPConnectHost: Failed to resolve host 'www.oasis-open.org' - Non-authoritive host not found or server failure.
runtime error: file xml/openacs.xsl line 392 element call-template xsl:call-template : template tr.attributes not found
NotesDebian has a problem where it can take 20 minutes to compile the docs, whereas it's 30 seconds or so usually it is apparently because debian doesn't ship with ''catalog'' files for docbook. To get around this, you can play with the --nonet and other flags for xsltproc.
Documentation and CVS branch policyJoel says:
Until 5.0 shipped I was using the rule that all docs should go on 5.0, because docs are risk-free so it's okay to stick them in at the last minutes. If we do doc work in HEAD, it will never show up in 5.0.1. One solution is that doc work goes on the branch but docs alone are batch-merged every week.