Why is the Zend Framework API documentation that poor? [closed]

Question

Is it my browser that doesn't work with their API online documentation?

The structure of it seems to be very bad compared to the Java API online documentation and the Yii API online documentation.

I am new to Zend Framework, so I wonder, should it be like that?

Answer 1

I think the API is nice, the only problem sometimes they don't give real meaning of arguments

After the API is maybe a bit behind some java examples, but I find the reference guilde quiet impressive and complete. You've got 900 pages describing every piece of the framework with short code snippet that's just wonderful.

Personally I use more often the reference guide then the API documentation.

Answer 2

I've been digging into Zend Framework for about a month now. I'm starting to catch on but I have to agree with the initial comment. The API documentation, at least what is available, is atrocious. What is this Dojo stuff anyway? I would expect a proper, standardized API reference for something as extensive and powerful as the Zend Framework. For an experienced software engineer the reference manual is really introductory material. Once it is digested all that is really needed is a good API reference that clearly shows properties, methods, inheritance tree, with brief descriptions where necessary. Like Java, AS3, etc. I could have saved myself about two weeks of time had I had full access to the API. I don't get it, but I intend to persevere with ZF.