I uploaded improved versions of the documentation and the ad.tcl files to the CVS tree, but that hasn't been released yet. I made them available here (http://fslc.usu.edu/openacs).
I tried to make them well commented out and easy to follow through. Enjoy.