A lo largo del episodio de hoy hablamos sobre la importancia que tiene la documentación del código fuente.
A continuación te dejo un pequeño resumen de lo hablado en el podcast:
- Comentar código fuente te ayudará para la creación automática de documentación de tu API siempre y cuando sigas un estándar a la hora de escribir tus comentarios. Uno muy utilizado en el mundo Java es Javadoc.
- Comentar código fuente te ayudará a comprender de manera rápida el código fuente que escribiste hace un tiempo ó el código fuente de otra persona, sin tener que leer el código fuente en sí.
Por todo ello es muy importante y una muy buena costumbre la de documentar el código fuente que escribamos, ya sea Java, Delphi, Python o cualquier otro.
Y esto es todo el en episodio de hoy de “Aprende a Programar, el Podcast”. Mi nombre es Emilio Pérez y puedes encontrarme en Facebook y escuchar este podcast tanto en iTunes como en iVoox y si pones algún comentario te estaré muy agradecido porque es algo que me ayuda a llegar a más gente..
Y como comento en el podcast, os pido que me escribáis con ideas y que compartas este podcast con otros amigos que estén interesados en el mundo de la programación y las bases de datos.
La entrada 18. Documentar código fuente aparece primero en Emilio Pérez.