la mejor forma documentar el codigo, cual ¿?

[eulerss]

pues la mejor forma a mi entender es en el mismo código, aunque quiza tenga la desventaja de que el archivo resultante sea un poco mas grande y posiblemente tarde mas tiempo en cargar (hablando de código para una web), otra opcion es replicar el mismo codigo y comentar linea por linea, no se me ocurre otra forma de comentar efectivamente el código, aunque siempre es bueno, tener un word con toda la documentación y requerimientos y demás, dale una leida a ITIL como mejores practicas

saludos