Forum OpenACS Q&A: Response to Newbee documentation

Collapse
Posted by Torben Brosten on
Aernout Schmidt, I am creating end-user documentation, and am also compiling a proposal for additions and changes to the Site and Content Administrators, and Beginning Developers documentation. (I'm starting to call the docs the OpenACS maze. =) Quite honestly, I think the documentation could best be organized in a database that sorts and filters the information according to reader's priorities and needs --but that is a discussion for later (when I am able create such a monster in OpenACS myself).

Most of the notes are gathered from board discussions and piecing together existing documentation. I'm sure your notes would be helpful to me, but I am not sure I would be much of a help to you at this time as I am in a similar predicament with OpenACS.

I suggest you post questions and comments to the board. This has important side-effects:

  1. more than 1 person may answer with more than one perspective on the topic
  2. there is a greater chance that someone will be inspired to write an eloquent explanation which can then be incorporated into the documentation
  3. the answer becomes immediately available for anyone who manages to find it via the forum search

For openACS, you will want to also contact the people mentioned for document contributions on this page: https://openacs.org/contribute (and keep me posted, with any notes you have, also: torben@kappacorp.com ).

For DotLRN, you should probably inquire in the dotLRN forum on who to contact: https://openacs.org/bboard/q-and-a.tcl?topic_id=15&topic=dotLRN%20Development