Richard I agree (although I don't share your opinion on the quality of the docs) they are both important... but....
'it feels like butter thats been spread over too much bread'
There's no getting around it. The resources aren't there to cope with everyhting to the same level. My argument therefore is that we focus on docs that help the people who need it most. Newer users, non-techs, techies with less experience.
The reasoning here is that I think everyone would accept that once you know OpenACS well you can make progress rapidly and do many usefult things....
But.. and I guess this is virtually a design flaw, its learning curve is way to steep initially. The initial mountain to climb is too steep for many...
I recall when we ran a bootcamp for aD (with Eve, Dave and so on attending) that they themselves barely had a grasp of it all!
So, we either flatten the curve, or we provide good tools (docs) top help people up it...
I'm kind of saying, 'Don't write docs for me, I;ve got the hang of it now... write them for people who need them'..
