John Anderson, one of the authors of the CakePHP manual asks in his google groups posting:

Anything you wish was documented better?

If you ever complained about a lack of documentation, go and help to improve the documentation with saying what you wish!