samedi 14 janvier 2012

Du code bien expliqué avec docco.coffee #javascript

Pour expliquer le contenu d'un programme, il n'y rien de mieux que les annotations en marge du listing.  Cette opération est maintenant automatique avec l'utilitaire docco.coffee. Il fonctionne  avec node.js, il utilise la librairie python 'pygments'.


Il fonctionne très simplement:  docco *js ou docco *coffee ,  va créer un répertoire 'docs' qui contiendra une page HTML.

Tout ca donne vraiment envie d'écrire de la doc.




Aucun commentaire: