Transverse
Le manifeste
J’aimerais que MTTL devienne une référence et je sais que cela ne se décrète pas. Voici les règles que je m’impose sur chaque page. Si vous en trouvez une que je n’ai pas tenue, signalez-le.
Je relie chaque sujet au reste de l’entreprise
Section intitulée « Je relie chaque sujet au reste de l’entreprise »L’observabilité n’appartient pas à la DSI. Une décision technique a un coût, elle pèse sur des personnes, elle a des conséquences d’organisation et elle sert ou dessert un métier. Je termine donc chaque article et chaque formation par un encadré Passerelles qui dit concrètement ce que le sujet change pour le business, l’organisation, les équipes et les métiers. Quand je n’arrive pas à remplir cet encadré, je considère que le sujet n’est pas prêt et je ne le publie pas. Voir Passerelles.
J’écris à partir de ce que j’ai vu
Section intitulée « J’écris à partir de ce que j’ai vu »Chaque article part d’un problème rencontré en production ou en mission, jamais d’une fiche produit. Quand une affirmation repose sur mon expérience personnelle, je l’écris comme telle.
Je publie la configuration que j’ai fait tourner
Section intitulée « Je publie la configuration que j’ai fait tourner »Les configurations publiées sont complètes et testées. Elles sont versionnées dans un lab GitLab que vous pouvez cloner et lancer. S’il m’arrive de publier une configuration que je n’ai pas testée, l’article le dit.
Je source les chiffres ou je dis qu’ils sont illustratifs
Section intitulée « Je source les chiffres ou je dis qu’ils sont illustratifs »Un chiffre est soit sourcé, soit présenté comme un scénario illustratif. Je préfère un ordre de grandeur honnête à un pourcentage spectaculaire.
Je traite tous les éditeurs avec la même exigence
Section intitulée « Je traite tous les éditeurs avec la même exigence »Solutions commerciales et open source passent par les mêmes critères. Mes liens d’intérêt sont déclarés en bas de page.
J’écris en français et je traduis
Section intitulée « J’écris en français et je traduis »Je rédige d’abord en français. Les pages structurantes existent en anglais et je traduis les articles au fil de l’eau. Une page pas encore traduite s’affiche dans sa langue d’origine, avec un avertissement.
Je date et je révise
Section intitulée « Je date et je révise »Chaque page porte sa date de dernière mise à jour. Certains sujets bougent vite, comme les conventions sémantiques OpenTelemetry ou l’observabilité des LLM. Je les révise et j’indique la révision.