WIKI HANDOVER CLIENT
Prérequis
- Projet web livré ou en fin de recette
- Compte Notion (client ou espace partagé agence)
- Inventaire des accès, environnements et documentation technique existante
- Template agence « Handover web » prêt à dupliquer
La mise en production n'est pas la fin du projet : sans handover structuré, le client ne sait pas mettre à jour une page, qui contacter en cas de panne, ou où trouver les identifiants. Un wiki Notion partagé centralise la passation et réduit les tickets « comment on fait déjà ? ».
Structurer l'arborescence du wiki
Page racine « [Client] — Documentation site » avec sommaire cliquable. Section « Démarrage rapide » : URL prod, URL staging, qui contacter, délai de réponse support.
Section « Contenus et CMS » : créer une page, publier un article, gérer les médias, limites de l'éditeur. Captures annotées ou liens Loom.
Section « Technique (lecture) » : stack (Next.js, hébergeur), variables d'environnement sans valeurs, rollback, calendrier maintenance, lien runbook.
Rédiger pour le client, pas pour les devs
Vouvoiement cohérent avec la marque client. Phrases courtes, une action par paragraphe. Évitez le jargon non expliqué (SSR, webhook).
Chaque procédure suit : objectif → prérequis → étapes numérotées → « Si ça bloque ». Callouts Notion sur les actions irréversibles (cache prod, migration DB).
Liez maquettes Figma, ClickUp de recette et rapports accessibilité : le wiki est la porte d'entrée, pas l'unique source.
Permissions, partage et maintenance
Accès invité pour les éditeurs client (commentaire ou édition sur sous-pages CMS). Section technique en lecture seule ou réservée IT client.
Documentez la date de handover et la version du site (tag Git ou release) en en-tête du wiki.
Prévoyez une page « Changelog handover » et revoyez le wiki à chaque release majeure : captures valides, contacts à jour.
Erreurs fréquentes
Wiki livré le jour J sans walkthrough live : le client ne l'ouvre jamais.
Screenshots obsolètes dès la première évolution : perte de confiance.
Tout empiler dans une seule page longue : impossible à scanner.
Oublier les limites du contrat (périmètre support, heures incluses).
Ce qu'il faut retenir
Template dupliqué + sections fixes = handover rapide et homogène.
Procédures actionnables pour les éditeurs ; technique en lecture contrôlée.
Secrets dans un coffre, pas dans Notion partagé largement.
Changelog et revue à chaque release pour garder le wiki vivant.
FAQ
Notion gagne pour la recherche, les mises à jour et les liens internes. Un PDF d'export peut servir de snapshot contractuel à la livraison.
Idéalement dans l'espace Notion du client pour la pérennité. L'agence peut co-administrer pendant la garantie puis transférer la propriété.
Le wiki client porte l'usage et l'exploitation. La doc développeur (README, ADR) reste dans le dépôt ; le wiki y renvoie en une ligne.