Conforme va creciendo una aplicación, se va complicando el manejo del proyecto, por ejemplo para que sirva cada clase, cada método, cada atributo, y no solo para el desarrollador, sino para todos los colaboradores y así ellos puedan entender partes del código sin necesidad de analizar el código línea a línea. ¿Qué es PHPDoc? Wikipedia dice: es una adaptación de javadoc para php que define un estándar oficial para comentar código php, con las siguientes características: Hace comentarios que pueda leerse en un método estándar para animar a los programadores a definir y comentar los aspectos del código que normalmente se ignoran. Permite que los generadores de documentos externos como phpDocumentor puedan crear la documentación API en buen formato y fácil de entender. Permite que algunos IDEs como Zend Studio, NetBeans y Aptana Studio interpreten los tipos de variables y otras ambigüedades en el lenguaje de programación. DocBlock Son bloques de comentarios y se suelen...