Writing Documentation

In addition to commenting and structuring, it's important to pay attention to documenting. The documentation for a project is probably the first part of the project that your customers will see, and the first impression is the one that counts.

Professionally laid out documentation that contains more than the obligatory "Follow the installation instructions in the README" should be a routine step in your development process. Just as you expect a well-written manual for your cell phone, new monitor, or other technical item purchased in even the smallest store, your customers expect good documentation from you (not to mention that they're probably paying you a lot of money for it).

As with comments, extensive documentation ...

Get Web Application Development with PHP 4.0 now with the O’Reilly learning platform.

O’Reilly members experience books, live events, courses curated by job role, and more from O’Reilly and nearly 200 top publishers.