Retour à l'accueil du SAV de la Tech
39. Convaincre mes devs de compléter la documentation
Cette semaine, le SAV de la Tech répond à la question de Philippe:
"comment convaincre mes devs à compléter la documentation de notre produit au fur et à mesure des évolutions ? Non seulement c’est important pour les utilisateurs du produit, pour le support mais aussi pour que les devs trouvent rapidement des réponses aux questions qu’ils se posent pendant leurs taches.
Par exemple, un dev à bloqué une semaine sur sa tache parce que le collègue qui était expert sur une partie du produit était en vacances. Si son expertise avait été documentée, on aurait pu économiser cette semaine.
Parfois même, les développeurs se contentent de laisser un commentaire sur une page de documentation, pour proposer d’effectuer un ajout ou une modification, au lieu de faire la-dite modification directement !
Certes la documentation est centralisée dans un outil dédié dont l’ergonomie n’est pas top, mais il reste possible de faire un copier-coller depuis Word par exemple.
Bref, je suis preneur de vos conseils si vous en avez !"
Épisode enregistré pendant l'été 2025.
Mastering audio automatisé par auphonic.com.
Crédits musique: "Guess Again", provided by https://slip.stream