44 liens privés
L'auteur résume une conférence expliquant comment structurer la documentation
Tout est dans le titre
De la doc et manuels informatiques
D'après la documentation, le module doctest cherche des extraits de texte ressemblant à des sessions Python interactives avant de les exécuter, de façon à vérifier que le fonctionnement correspond exactement à la description.
et d'après l'article, il s'agit surtout d'une documentation testée. J'aime beaucoup le principe
Tout est dans le titre
L'auteur effectue le refactoring d'un test en appliquant plusieurs techniques / idées pour le rendre plus lisible.... très intéressant
Tout est dans le titre
L'auteur explique l'intérêt d'utiliser Asciidoc pour générer sa documentation
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Le dernier article de la série sur la meilleure architecture d'une application Symfony : documentation grâce à NelmioApiDocBundle avec génération de Swagger
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Tout est dans le titre
Un article très intéressant sur la documentation et de bons conseils / outils pour la générer / la faire vivre