我的浏览器是否与their API online documentation不兼容?
与Java API online documentation和Yii API online documentation相比,它的结构似乎非常糟糕。
我是Zend Framework的新手,所以我想知道,它应该是这样吗?
答案 0 :(得分:5)
我认为API很好,唯一的问题有时它们没有给出参数的真正含义
API可能稍微落后于一些java示例,但我发现reference guilde安静令人印象深刻且完整。你已经有900页描述了框架的每个部分,其中包含很短的代码片段。
就个人而言,我经常使用参考指南和API文档。
答案 1 :(得分:3)
我一直在挖掘Zend Framework大约一个月了。我开始流行,但我必须同意最初的评论。 API文档,至少是可用的,是非常残酷的。无论如何,这个道场的东西是什么?对于像Zend Framework这样广泛而强大的东西,我希望有一个适当的,标准化的API参考。对于经验丰富的软件工程师而言,参考手册实际上是介绍性材料。一旦它被消化,所有真正需要的是一个很好的API参考,它清楚地显示属性,方法,继承树,并在必要时进行简要描述。像Java,AS3等一样,如果我有完全访问API的话,我本可以节省大约两周的时间。我不明白,但我打算坚持ZF。
答案 2 :(得分:1)
对我来说,问题是参考指南只是简单地列出了所有组件,并且有一个庞大的页面,告诉每个组件的长途使用,而不是所述代码应该出现在工作流程中的范围。
我认为应该重新考虑像CakePHPs文档一样,每个页面的目标都是完成特定任务,例如"保存数据","删除数据","验证数据"等等。
带有上下文的现实生活示例比Zend Docs更有用,我倾向于猜测某些变量(通常是$db
)来自哪里 - 而在完整的MVC情况下,甚至不是应用