Ver Mensaje Individual
  #1 (permalink)  
Antiguo 20/05/2014, 10:31
Avatar de guardarmicorreo
guardarmicorreo
 
Fecha de Ingreso: noviembre-2012
Ubicación: Córdoba
Mensajes: 1.153
Antigüedad: 12 años
Puntos: 84
¿Cuales son las maneras más correctas de documentar un programa?

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?
__________________
Ayúdame a hacerlo por mi mismo.