The codex is utter crap when it comes to finding info. Especially in regards to the hooks and how to use them.
The layout, the examples, just about everything except the function list I find of very poor quality. (And most is for use with PHP4. examples should include PHP5 because its much better.)
Just take the add pages to the admin for example. There lack a couple of functions there. For example add_object_page which adds an page that doesnt show in the menu. Very useful but nowhere to be found in codex.

Oh well. I really don't like the codex in any way shape or form. well its better than nothing =)

@Jeffro - Aint that what Jane? talked about? Making different versions requires different type of language also. First separate end user and developer . Then you can devide each to sub categories. I can think of a bunch of stuff but I would probably have to write a blogpost about to get it all down.