39. Convaincre mes devs de compléter la documentation episode artwork

EPISODE · May 22, 2026 · 18 MIN

39. Convaincre mes devs de compléter la documentation

from Le SAV de la Tech · host Jérémie Girault × Adrien Joly

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

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

NOW PLAYING

39. Convaincre mes devs de compléter la documentation

0:00 18:36

No transcript for this episode yet

We transcribe on demand. Request one and we'll notify you when it's ready — usually under 10 minutes.

Frequently Asked Questions

How long is this episode of Le SAV de la Tech?

This episode is 18 minutes long.

When was this Le SAV de la Tech episode published?

This episode was published on May 22, 2026.

What is this episode about?

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...

Can I download this Le SAV de la Tech episode?

Yes, you can download this episode by clicking the download button on the episode player, or subscribe to the podcast in your preferred podcast app for automatic downloads.
URL copied to clipboard!