I'm a new user of Drupal, and getting my head around the documentation is proving to be a bit of a pain.
I'm not new to programming and I find PHP fairly easy to use, but understanding the availability of variables, the behaviour of various core modules, and how PHPtemplate works is very time consuming because many of the useful informational and tip posts can only be found in the forum or buried deep within the handbook hierarchy. This is a big problem as Drupal.org's search feature isn't the best, the categories are limited to the major recent versions of Drupal, and venturing deeper into the Handbook requires clicking multiple expandable menu headings.
Additionally it is not apparent how to correct small errors within the Handbook, aside from posting comments and waiting for someone with privileges to edit the entry? I don't understand why you'd create the ultimate user-modifiable open source CMS but limit editing the documentation system to only a privileged few?
It seems to me most of the problems with Drupal's documentation system could be resolved by moving the docs to a separate wiki site, possibly tied in to the Drupal.org user database (if possible).
FYI I came to Drupal from WordPress, who run a very useful wiki.
I have no problem contributing to such a wiki-fication project as I run a couple of small