Forum OpenACS Q&A: Response to OACS course - webmaster's documentation

Collapse
Posted by Peter Alberer on

Hi Rafael,

i think its great that you create such a documentation. I had some students in the last year working on openacs-projects and most of them needed quite a long time to learn about the system from the standard documentation. so i think the following things will definitely help people to understand acs: (things i did not see in your document yet)

  • webmasters things
    • explanation of the server-config file
  • Developers things
    • directory structure of a typical package
    • explanation of the various file types in a package (tcl,adp,xql) and how those work together
    • how to change the looks of a subsite with a new master.adp
    • some simple graphs showing the core parts of the datamodell
    • some simple interactions with the acs-api everyone needs (how to use the page contract,how to get the accessing user_id,query the db),
now that i wrote that i see that these are mostly topics relevant to developing new packages ...