Documentation is a critical part of PEAR. Even the most interesting and helpful package will not be used without proper documentation that helps users understand it.

Documentation for a package in PEAR means two things:

API documentation is automatically generated after a package has been released on from the code using phpDocumentor.

The second type of documentation needs to be created manually. It is the documentation you see in this very manual below the packages book.

At first you will learn how to obtain and render this manual before going into detail about writing documentation for your own package.