Todos valoramos los buenos comentarios en el código, pero también es cierto que escribirlos lleva tiempo y no siempre se tiene. Aunque muchas veces simplemente no se quiere, solo por ser vagos. Ahora, si me dicen que mi código va a quedar documentado tan bonito como el clásico ejemplo de la aplicación de Todo hecha en backbone.js, lo pensaría dos veces.
Para los que quieren pensarlo dos veces, en python pueden usar Pycco,
pip install pycco
pycco app/*.py app/static/js/myapp.js
Y en docs/ vamos a encontrar nuestro código a 2 columnas con todos los comentarios extraídos a la izquierda.
Si gustan de Node.js pueden usar Docco.
18 abril, 2012 4:29 pm
python