pour ma part j'aime beaucoup l'approche d'une doc rédigée directement dans le code, avec des exemples qui sont testés
Merci pour le retour.
Je ne vise pas en fait ce type de documentation, qui explicite le code et le design, et donc est légitime à être dans le code, et qui se destine aux personnes qui doivent intervenir dans le code ou la conception.
Je cible plutôt une documentation vraiment "utilisateur", qui décrit le comportement attendu (cf. BDD, ATDD).
[^] # Re: Très intéressant commme approche
Posté par Lionel Draghi (site web personnel) . En réponse au journal Documenter ou tester, il faut trancher (j'ai pas trouvé de rime avec choisir...). Évalué à 2.
Merci pour le retour.
Je ne vise pas en fait ce type de documentation, qui explicite le code et le design, et donc est légitime à être dans le code, et qui se destine aux personnes qui doivent intervenir dans le code ou la conception.
Je cible plutôt une documentation vraiment "utilisateur", qui décrit le comportement attendu (cf. BDD, ATDD).