Tom, I think that is the kind of doc I don't find useful. It's good for techies, but for newbies or for non-techies it's murder. The Big Picture thing is good, but it explains practically nothing most of the time.
I posted a suggestion for how to approach documentation at the thread Jerry started here (https://openacs.org/bboard/q-and-a-fetch-msg.tcl?msg_id=00025b&topic_id=11&topic=OpenACS)
talli