Accueil InfoQ Documentation sur InfoQ
Articles
Flux RSS-
Q&R Avec Cyrille Martraire Pour Son Livre Living Documentation
Pour Cyrille Martraire, nous devrions repenser la façon dont nous travaillons avec la documentation quand nous développons des systèmes logiciels : nous devrions adopter une documentation qui évolue en même temps que le code. Dans ce livre, il décrit les concepts et les idées à la base d’une documentation vivante et utilise des exemples pratiques pour créer une documentation toujours à jour.
-
Pratiques pour une Documentation Lean
La connaissance système ou métier, importante à la fois pour la qualité et l'efficacité, se transfère le mieux par un dialogue en face à face. Quand il n'est pas possible, la seule solution est une documentation lean. Voici 6 pratiques pour maximiser l'information en minimisant le nombre de mots, ce qui rend la documentation plus facile à utiliser et à maintenir.
-
Je Préfèrerais Coder - Mettre les Choses par Ecrit
Les développeurs détestent vraiment passer du temps à écrire, à moins que ce ne soit du code. Cependant, dans la vie d'un projet, un peu de documentation peut faire la différence. Dans cet article, nous verrons pourquoi et quand écrire noir sur blanc.