Por 
La documentación de un programa es algo muy importante pero que muchos programadores no lo realizan por pereza o porque no lo consideran importante, pero la realidad es otra ya que cuando no se realiza la documentación luego los usuarios no sacan el mayor provecho del programa o causan muchas llamadas al programador para que explique como se usa. Bueno pero para facilitar la tarea de generar la documentación aqui te dejo 2 scripts que lo harán de manera más fácil o hasta automática.
- phpDocumentor
Una herramienta para la documentación de código fuente PHP. Posee una gran cantidad de funcionalidades incluyendo la capacidad de exportar en formato HTML, PDF, CHM y XML DocBook. Cuenta con dos interfaces: una browser (de navegador) y otra a través de consola (línea de comando). Hasta viene con un resaltador de código fuente… - PHP DOX
Es un buscador de documentacion AJAX para PHP: busca títulos entre todas las páginas de documentación PHP.
En mis años estudiantiles los profes nos decían que antes de programar, primero analizar y documentar.
Y así lo hacía, pero en la chamba la documentación es lo de menos, lo que quieren es que funcione YA que porque nos gana la competencia.
Luego me tienen buceando y parchando código porque desde el principio no se documentó
Chale!