Pourquoi écrivez-vous de si mauvaises documentations, alors que votre code est de bonne qualité ?

3 novembre 2022documentation, qualité, humeur

L’architecture et le code de nos projets, quand nous pouvons faire du bon travail :

Un magnifique chateau de sable

Un magnifique chateau de sable — Kit Suman sur Unsplash


Les documentations de ces mêmes projets :

Un chateau de sable en ruines

Un chateau de sable en ruines — Phil Hearing sur Unsplash


Nos documentations sont sans ambition. Nous ne faisons pas d’effort pour les structurer ni les rédiger. Elles sont très vite obsolètes et abandonnées, non maintenues et inutiles. Voire contreproductives.

Conférencier, conférencière : quand vous êtes dans le public, aidez la personne sur scène !

15 septembre 2022speaker

Dans une salle de conférences, je vois deux types de personnes :

  • celles qui sont montées sur scène auparavant et qui savent ce que ça fait ;
  • et celles qui n’osent pas encore, qui tremblent à l’idée de ce que ça leur ferait ou fera.

Vous avez déjà parlé en public ? Vous êtes conférencier ou conférencière ?
Vous êtes mieux placée que qui que ce soit pour aider vos collègues !

Transcript de ma conférence « Préparez et donnez votre premier talk » à Sunny Tech 2022

6 septembre 2022conference, transcript

Le 1er juillet 2022, j’étais à Sunny Tech, pour ma conférence « Préparez et donnez votre premier talk ». J’ai déjà donné cette présentation plusieurs fois en différents formats et durées et elle a été enregistrée en vidéo au moins à deux occasions :

Je sais que tout le monde n’accroche pas avec le format vidéo et que beaucoup préfèrent du texte, donc, ci-dessous, une tentative de transcript de cette conférence telle que je l’ai donnée à Sunny Tech – en version courte, donc.

Écrire m’a ouvert des portes

30 août 2022ecriture, carrière, auteur, mylife

J’ai commencé à partager des textes sur Internet pendant le lycée, en 2000 ou 2001 : j’ai écrit le tutoriel en français pour apprendre à programmer en C pour calculatrices TI-89 et TI-92+.

Quelques mois plus tôt, quand j’avais découvert cet univers, les guides étaient rares et les documentations en anglais1. Peut-être que j’allais aider d’autres personnes à se lancer ?

Au fil des années, j’ai rencontré des dizaines de membres de cette communauté, nous avons passé plein de bons moments ensemble… Et j’ai entendu pas mal de fois « j’ai commencé avec ton tuto » ❤️


Aujourd’hui, on me demande régulièrement ce que écrire m’apporte, pourquoi je le fais.

Au-delà du fait que j’apprécie partager, que j’aime écrire, que je réfléchis en écrivant et que mettre mes pensées sur papier me force à les organiser et me donne une certaine clarté, écrire a sans aucun doute aussi eu des effets positifs sur ma carrière.

Partez en vacances, plusieurs semaines, sans regarder Slack ni vos mails, quand vous êtes lead !

18 août 2022management, vacances, travail

Un de mes premiers chefs répondait plus souvent et plus rapidement aux mails quand il était en congés que quand il travaillait officiellement1.
Une réaction seulement en fin de journée ? Nous savions qu’il dépilait après son tunnel de réunions. Un retour dans les dix minutes ? Il était en vacances et n’avait pas de meetings !

Nous trouvions ça marrant, original. Peut-être triste aussi. Mais nous pouvions compter sur lui. Avec le recul, nous comptions sans doute un peu trop sur lui !