Si O’Reilly se animara alguna vez a publicar los títulos de Los 10 mejores libros de programación que NUNCA verás en las estanterías, probablemente “Copiando y pegando de Stack Overflow” se convertiría en un súper ventas.
Etiqueta: documentacion
Aunque el inglés es un idioma que yo considero que hablo bastante bien (academia, escuela oficial de idiomas, parte de la carrera en inglés…) siempre es agradable poder leer un texto en tu lengua materna. Esto es un problema cuando…
A menudo, la documentación del software consiste en grandes, pesados y amenazadores manuales que nadie nunca lee. De hecho, durante los últimos cinco años, la mayoría de los manuales que venían con productos software han sido en realidad copias de…
Docstrings En artículos anteriores del tutorial de Python ya comentamos en varias ocasiones que todos los objetos cuentan con una variable especial __doc__ mediante la que indicar el propósito y uso del objeto. Estos son los llamados docstrings o cadenas…
La mayor parte de la documentación comienza consistiendo en pequeñas notas rápidas ilegibles escritas por desarrolladores privados de sueño y a los que no se les contrató necesariamente por su habilidad para la comunicación. Estas notas las reescriben graduados en…
Para seguir con el tema de los comentarios en el código, os dejo este enlace a un pequeño plugin que integra el sistema de documentación que suelo utilizar últimamente (Doxygen) en Eclipse. Eclox permite crear archivos doxyfile con la configuración…