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:
Enregistrer un commentaire