I started looking at PHP Frameworks for rapid development (I got a little tired of reinventing the wheel for every project I do). I have so far looked at Cake, Trax, Zend, and Symfony. So far, symfony looks to be the best. However, all frameworks suffer from one fatal flaw: garbage documentation. (Aside from Zend...but I don't like it for some reason) Despite the fact that Symfony has its own book and some pretty good tutorials, it still lacks a class and function reference. It gives great examples on how to use some of the features, but the rest are doomed to obscurity. As a prominent example, (in symfony documentation), there are numerous references to the pagination class (which is pretty darn important), but no explanation of how to actually use it! If I have to reverse-engineer this from looking at the backend code, this saves me next to no time in development.
To me, these frameworks need php-style documentation. Every class and every function documented with usage guidelines, examples, and warnings; same way the language itself is documented. Does anyone have any further comments, or perhaps suggestions as to what I should use? Keep in mind: I know PHP, but I know nothing about these frameworks. Thanks.