This is key to reducing the barrier to entry for most users.
For example, the configuration component Zend_Config is used to provide an object oriented interface to
a configuration file. It supports two advanced features: section overloading and nested keys, but neither of
these features need to be understood in order to use the component. Once the user has a working
Licensed to Menshu You
Please post comments or corrections to the Author Online forum at
http://www.manning-sandbox.com/forum.jspa?forumID=329
implementation of Zend_Config in their code, confidence increases and so using the advanced features is a
small step.
1.2.4 Full documentation
No matter how good the code is, lack of documentation can kill a project through lack of adoption. The Zend
Framework is aimed at developers who do not want to have to dig through all the source code to get their job
done and so the Zend Framework puts documentation on an equal footing with the code. This means that the
core team will not allow new code into the framework unless it has accompanying documentation.
There are two types of documentation supplied with the framework: API and end-user. The API
documentation is created using PHPDocumenter and is automatically generated using special ???docblock???
comments in the source code.
Pages:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25