ZF2-182: Better API documentation
As a programmer (= a framework user) I'm very dissatisfied with the current API documentation. For me it is a confusing labyrinth with awful design, a browser-killer (yes, using the search feature can really kill your browser) and apparently it doesn't really care about the code integrity. It does not help me with my work as it should.
After a discussion with my colleagues from the PHP community (guys moving around Doctrine, Symfony, Nette, etc.), I've found out that I'm not the only one who finds this API horrible and I decided to contact you this way and propose you a solution that we consider the "top-of-the-range":
Check out an open source tool called ApiGen: http://apigen.org/ Or better - go straight to see the difference between http://framework.zend.com/apidoc/1.11/ and http://apigen.juzna.cz/doc/komola/ZendFramework/. Do you see that?
ApiGen is a fresh, elegant tool, which is fast, already supports PHP 5.4 (yes, DocBlox is announcing PHP 5.3 support as something exceptional), still is being improved, has an agile community and starts to gain more and more fame in the PHP community. There's even a first experimental version of cloud-based API doc generating directly from Github (http://apigen.juzna.cz/).
Think about it, guys! ;)