Issue Type: Docs: Improvement Created: 2012-02-28T23:54:44.000+0000 Last Updated: 2012-10-08T20:15:27.000+0000 Status: Closed Fix version(s): Reporter: Jan Jakeš (juan) Assignee: Ralph Schindler (ralph) Tags: Related issues: Attachments:
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! ;)
Posted by Frank Brückner (frosch) on 2012-03-01T11:32:07.000+0000
Hi Jan, ApiGen looks good and it works! :)
Can you communicate this on the mailing list? Thanks!
Posted by Ralph Schindler (ralph) on 2012-10-08T20:15:27.000+0000
This issue has been closed on Jira and moved to GitHub for issue tracking. To continue following the resolution of this issues, please visit: https://github.com/zendframework/zf2/issues/2457
Have you found an issue?
See the Overview section for more details.