En mi camino de aprender a programar siempre he tenido la sensación de que la forma de documentar un programa queda en manos de la subjetividad.
He visto código nada documentado, código con un simple comentario sobre una propiedad sin indicar nada de ella, simplemente lo que hace y por mi parte trato de especificar qué hace una clase, qué hace un método, lo que devuelve y cuales son sus parámetros.
En PHP ¿cuales o cual es la manera más correcta de documentar un programa?