Mastodawn

La documentation qui vit uniquement dans les têtes des seniors ou dans des comptes-rendus de réunions introuvables, c'est un SPOF. Le jour où la personne-clé est absente, tout le monde galère. Écrire, versionner, rendre accessible : ça coûte infiniment moins cher que l'héroïsme 😑

sebsauvage 2d ago

@carlchenet
Mais TELLEMENT.
J'insiste tellement sur la documentation auprès de mes collègues.

L'un des moyens de s'en apercevoir, c'est d'expliquer à des collègues un truc qui semble évident pour toi. Là tu te rends compte que ce n'est absolument pas évident pour les autres. Il faut vraiment tout expliciter.

mikeTesteLinuxQlub 2d ago

@sebsauvage @carlchenet Ça dépend de la qualité de la doc et de si elle a été maintenu à jour, car parfois, tu vas galérer encore plus 😆

Carl Chenet 2d ago

@mikeTesteLinuxQlub @sebsauvage oui c'est sûr,la base de données de connaissances, c'est un vrai boulot à gérer

mikeTesteLinuxQlub 1d ago

@carlchenet @sebsauvage Ouin, j'ai vu le bordel que ca nécessite, je supporte l'équipe de support ti et maudit que cé complexe de la bonne doc, surtout que des fois ils sont juste complètement mélangés 😂

Carl Chenet 2d ago

@sebsauvage oui, c'est même fascinant parfois de voir la différence de compréhension qu'on peut observer sur une phrase qu'on estime nous "simple" 😂

@carlchenet c'est vrai aussi dans les collectifs, les assos, les syndicats. Toutes les organisations sont concernés

> Quand un senior part c'est une documentation qu'on brûle

On un truc du genre. Je ne suis pas proverbiste.

Carl Chenet 2d ago

@dallo tout à fait, c'est valable quasiment partout

@carlchenet El famoso bus factor.

@carlchenet
Dicton courant chez les développeurs :
ça a été dur à écrire, il faut que ça soit dur à lire

Carl Chenet 2d ago

@parrot_33 ah oui ? je m'en souviendrai la prochaine fois que j'écris de la doc pour les devs 😂

@carlchenet
Sinon il y a aussi
Ne cherchez pas à comprendre comment ça marche, même moi je ne le sais pas

Carl Chenet 2d ago

@parrot_33 ah ça je connais ! C'est marrant quand ça arrive le week-end ou la veille du week-end d'ailleurs

Sauf si on espère que le produit (ou la société qui le propose) aura une courte durée de vie.

Carl Chenet 2d ago

@tanavit c'est les mêmes personnes qui ne pré-réservent pas d'instances sur le cloud car elles pensent que le projet va être court... et il est toujours là trois ans plus tard 😂 ainsi que la facture cloud

Patrick Prémartin 2d ago

@carlchenet mais non voyons : quand les seniors partiront il y aura des IAs pour leur aspirer le cerveau

Carl Chenet 2d ago

@pprem horrible 😱 🙀

Lorrassou 2d ago

@carlchenet Alors tout dépend du job, longtemps on m'a "tarabusquer" pour écrire des documentations "compréhensible pour un enfant de 10ans" concernant utilisation et maintenance d'appareils très spécifiques que seule une poignées d'individus connaissaient parfaitement d'expérience, mais sans aucun support. J'ai vite integré que le but non avoué était de founir ces materiels à d'obscures filiales concurrentes asiatiques, et je n'ai jamais rendu de supports compréhensibles par qui que ce soit😊.

Carl Chenet 2d ago

@laurross ah, ça ne m'est jamais arrivé ça. En général la documentation que j'écris est pour mon équipe ou les équipes autour.

@carlchenet Contrepoint, parfois (souvent) la « documentation dans la tête des seniors », ça s'appelle l'expérience.

Carl Chenet 2d ago

@Arcaik oui, tout à fait, et c'est toujours bien de l'avoir, mais c'est aussi de la responsabilité de la boîte d'assurer le passage de connaissances.

@carlchenet
Mais avec de la doc écrite, comment tu vas faire pour te rendre indispensable et pouvoir garder de l'ascendant sur tes collègues tout en évitant de te remettre en cause, bloquant au passage toute évolution dans ton service/boîte ?

Et puis pourquoi écrire de la doc que tes collègues ne liront pas car ils viennent systématiquement te déranger pour que tu bosses à leur place ? La doc ne sera utile qu'une fois que tu seras parti pour burnout et opportunément éjecté pour «incompétence»…

Carl Chenet 2d ago

@xvbg haha oui, mais bon, la rétention d'info, ça c'est à la boîte de gérer normalement