Ce que vous recevez, par écrit

Pourquoi cette page n'est pas une référence d'API

Nous ne vendons pas de produit : il n'y a donc pas d'API publique à documenter ici. Ce que nous produisons en revanche, sur chaque mission, c'est la documentation des systèmes que nous construisons puis exploitons pour le compte du client. C'est l'objet de cette page.

Cela compte plus qu'il n'y paraît. La principale raison pour laquelle une automatisation meurt discrètement quelques mois après sa mise en ligne, c'est que personne n'a écrit comment elle fonctionne et que la seule personne qui le savait est partie.

Ce que comprend chaque mission

Au moment de la livraison, l'ensemble s'accompagne de :

• une note d'architecture expliquant ce que fait le système, ce avec quoi il communique et pourquoi il est conçu ainsi
• des runbooks pour les incidents qui réveillent quelqu'un à trois heures du matin, rédigés pour être suivis par une personne qui n'a pas construit le système
• des enregistrements de décisions couvrant les arbitrages retenus et ce que nous avons écarté, pour qu'une évolution future ne rouvre pas des débats tranchés
• un inventaire des comptes, identifiants et accès, indiquant précisément ce qui existe, où et entre quelles mains
• un document de transfert, si et quand vous souhaitez l'exploiter vous-même

Où elle réside

Dans vos systèmes, pas dans les nôtres. Une documentation qui ne vit que dans le wiki d'une agence est un otage, pas un actif. Elle va là où votre équipe range déjà ses documents, dans le format qu'elle utilise déjà.

Elle vous appartient pleinement, avec le code et les définitions d'infrastructure, dès le premier sprint et non à la fin de la mission.

Si vous reprenez la main

Certains clients nous confient l'exploitation d'un système indéfiniment. D'autres le reprennent en interne une fois qu'il est stable. Les deux nous conviennent, et le second cas n'est pas un échec que nous chercherions à éviter en nous rendant difficiles à remplacer.

Quand vous voulez reprendre la main, nous rédigeons le transfert sérieusement et accompagnons votre équipe jusqu'à ce qu'elle puisse s'en occuper sans nous. Pas de dépendance forcée, pas de rançon, et pas de découverte qu'un identifiant critique n'existait que dans notre gestionnaire de mots de passe.

Des questions avant de commencer

Si vous voulez voir à quoi ressemble notre documentation avant de vous engager, demandez-le. Nous vous montrons un exemple anonymisé lors d'un appel. C'est une vérification légitime.