El artículo que hace mención Josemi sobre PHPDoc esta en:
http://www.devshed.com/Server_Side/P...Doc/page1.html
PHPdoc sitio oficial (descargas y documentación):
http://www.phpdoc.de/
Sobre el standar de PEAR (teoría):
Standares de PEAR:
http://pear.php.net/manual/en/standards.php
Ahí tienes todo .. desde identación del código .. hasta como poner comentarios a tu código .. Como veras es MUY estricto a la hora de "escribir" el código, pero de eso se trata .. de seguir unas normas standares para que cualquiera q lea tu código sepa interpretarlo de forma facil y ordenada.
Cuando programas algo (en cualquier lenguaje) hay como tres cosas a tener en cuenta:
1) q funcione
2) q sea optimo el código (tal vez aquí habria q meter otros conceptos como .. q sea modular o reutilizable .. etc.. Pero este no es el foro para discutir estos temas .. tenemos el foro "Ingenería del Software ....".
3) q esté escrito de forma limpia, ordenada y documentado correctamente.
Con esa classe q estas haciendo ya estas aprendiendo a seguir algunas normas .. normas q te las da la propia programación OOP .. Ahora estas en el punto 1. .. Para conseguir un buen desarrollo deberías llegar hasta el punto 3. Josemi por su parte ya te ha "introducido" en el punto 2 .. y si sigues las normas de PEAR por ejemplo llegaras al punto 3 con una buena aplicación.
Yo mismo recien estoy en el punto 2 y viendo cosas del punto 3 .. y me cuesta (todo esto por malas costumbres a la hora de programar) .. pero si quieres hacerlo bien .. hay q ceñirse algun standar.
Un saludo,