Playbook d'onboarding technique

Dans une scale-up SaaS B2B, chaque nouveau client grand compte déclenche un onboarding technique : authentification SSO, intégrations d'APIs, configuration multi-sites, imports de données, thèmes visuels.

Historiquement, ce savoir vivait dans la tête de deux ou trois personnes. Chaque déploiement était refait "de mémoire", avec les oublis et les allers-retours que ça implique.

Le symptôme classique du savoir non documenté : des onboardings dont la durée variait du simple au triple selon qui les pilotait, des étapes oubliées découvertes en production, et des experts internes transformés en goulots d'étranglement — impossible de partir en vacances pendant un déploiement.

La direction voulait standardiser. Le risque, connu de tous : produire un document que personne n'ouvre jamais.

J'ai découpé l'onboarding en 8 chantiers indépendants — de la collecte des prérequis client jusqu'à la recette finale — chacun avec ses entrées, ses livrables, ses points de contrôle et ses pièges connus.

Les choix qui ont fait la différence :

• Écrit depuis le terrain : chaque chantier a été documenté pendant un vrai déploiement client, pas en salle de réunion. Les captures, les cas limites et les messages d'erreur viennent de situations réelles.
• Un niveau de détail exécutable : l'objectif était qu'une personne compétente mais nouvelle sur le sujet puisse dérouler un chantier sans solliciter un expert.
• Vivant par construction : le playbook est structuré sur Confluence avec un propriétaire par chantier, et chaque déploiement qui révèle un manque déclenche une mise à jour.

Le playbook est devenu la référence de l'équipe Success : les déploiements suivent désormais le même chemin quel que soit le pilote, et les experts historiques ne sont plus un point de blocage.

Ce projet illustre une conviction : la documentation est un produit. Elle a des utilisateurs, des cas d'usage, et elle mérite le même niveau d'exigence que le code.