Coheris by ChapsVision
Responsable de la documentation — Docs-as-code et management multi-contribureurs
Éléments clés
| Catégorie | Données |
|---|---|
| Organisation | Coheris by ChapsVision |
| Période | De septembre 2022 à avril 2025 |
| Domaines | CRM, merchandising, gestion des stocks et forces de vente terrain |
| Rôle | Rédactrice technique senior et consultante, puis Documentation Manager |
| Périmètre | Audit documentaire, architecture, migration, rédaction, gouvernance et gestion des versions |
| Publics | Administrateurs, utilisateurs métier, intégrateurs, développeurs, équipes Support et Customer Success |
| Langues | Français et anglais |
| Environnement | Docusaurus, Markdown, GitLab, CI/CD, API REST, ReDoc, Confluence |
Présentation du projet
Coheris by ChapsVision développe des solutions logicielles de gestion de la relation client et de merchandising.
Ma collaboration a commencé par une mission de conseil de quatre mois consacrée à l'audit et à la refonte de la documentation de la suite Coheris CRM. À l'issue de cette première phase, j'ai rejoint l'entreprise en tant que Documentation Manager et étendu cette démarche à la gamme de produits Merch-Nomad.
Sur l'ensemble de la période, j'ai transformé des documentations historiques en portails documentaires bilingues et sécurisés, et mis en place un modèle docs-as-code pérenne et multi-contributeurs impliquant les équipes Produit, R&D, Support et Customer Success.
Contexte
La documentation CRM existante était répartie entre des livrables PDF obsolètes, produits avec plusieurs outils de rédaction. Cette organisation ralentissait les mises à jour, limitait la collaboration avec la R&D et compliquait l'alignement de la documentation sur les évolutions des applications.
La documentation couvrait également un vaste périmètre technique et fonctionnel : installation, mises à niveau, configuration, administration, fonctionnalités métier avancées, intégrations, API REST et flux de données externes.
L'objectif était de remplacer ce modèle fragmenté par des portails documentaires sécurisés, maintenables et orientés utilisateurs, capables d'évoluer avec les produits et de répondre aux besoins des publics francophones et anglophones.
Principaux livrables
Portails documentaires et modernisation des contenus
J'ai commencé par réaliser un audit complet de la documentation de Coheris CRM et par explorer directement les applications afin de comprendre les workflows techniques et les cas d'usage métier.
À partir de cette analyse, j'ai proposé et mis en œuvre une architecture documentaire unifiée avec Docusaurus et Markdown. Les mêmes principes ont ensuite été appliqués à la gamme Merch-Nomad, avec un portail dédié à chaque écosystème documentaire.
Le travail comprenait notamment :
- la migration et la restructuration des contenus historiques ;
- la création d'une documentation bilingue français-anglais ;
- la réécriture des contenus d'installation, de mise à niveau, de configuration, d'administration et des fonctionnalités métier ;
- la production d'exemples réalistes, de captures d'écran, de schémas et de workflows ;
- la modernisation de la documentation développeur consacrée aux API REST et aux intégrations ;
- l'intégration de ReDoc afin d'améliorer l'utilisabilité de la référence API.
Pour chaque version majeure des produits, j'ai créé et maintenu un site de documentation dédié, couvrant quatre applications réparties entre les deux gammes.
Docs-as-code, contribution et gouvernance
J'ai mis en place un workflow docs-as-code fondé sur GitLab et connecté au cycle de développement logiciel.
Les développeurs sont devenus co-contributeurs de la documentation grâce aux branches Git et aux merge requests, tandis que les Product Owners conservaient la responsabilité de la validation fonctionnelle. Les workflows CI/CD prenaient en charge la génération, la prévisualisation et la publication de la documentation sur les branches de développement et de release.
Au-delà du workflow technique, j'ai structuré le modèle de gouvernance documentaire autour de :
- roadmaps documentaires alignées sur les roadmaps produit ;
- processus de contribution et de révision ;
- planification documentaire par version ;
- priorisation entre les deux gammes de produits ;
- validation systématique par les Product Owners ;
- transformation des retours du Support et du Customer Success en documentation utilisateur réutilisable.
Cette approche a fait de la documentation une responsabilité produit partagée, tout en préservant sa cohérence éditoriale et sa qualité.
Mon rôle
J'ai piloté le cycle de vie documentaire de Coheris CRM et Merch-Nomad, en combinant stratégie documentaire, architecture, rédaction technique, mise en œuvre des portails, gestion des versions et gouvernance.
Mon rôle a évolué d'une mission initiale de conseil vers une fonction interne transverse à l'interface de la R&D, du Produit, du Support et du Customer Success. Je suis restée responsable de la cohérence, de la qualité, de la planification et de la publication de la documentation, tout en permettant aux experts métier et techniques de contribuer efficacement.
Technologies et outils
Docusaurus, Markdown, GitLab, Git, CI/CD, Visual Studio et VS Code, Sourcetree, Confluence, API REST, OpenAPI, Swagger, ReDoc, React, CSS et JavaScript.
Confidentialité
Les portails documentaires étaient sécurisés et destinés aux clients, partenaires et équipes internes. Ils ne sont donc pas accessibles publiquement et ne peuvent pas être intégrés directement à ce portfolio.
Cette page présente le périmètre, l'approche et les responsabilités associées à la mission sans divulguer de documentation propriétaire ni d'informations produit confidentielles.
© Florence Venisse, Experte en Documentation Technique & IA – Version révisée le 21/07/2026.