ChapsVision
Rédactrice Technique Senior Freelance — Documentation "from scratch"
Éléments clés
| Catégorie | Données |
|---|---|
| Organisation | ChapsVision |
| Période | De février à mai 2022 |
| Domaine | Préparation, exploration et analyse des données |
| Rôle | Rédactrice technique senior freelance |
| Périmètre | Architecture documentaire, exploration du produit, rédaction, tutoriels et mise en œuvre du portail |
| Publics | Administrateurs, utilisateurs techniques, spécialistes des données et intégrateurs |
| Langue | Français |
| Environnement | Docusaurus, Markdown, Azure Repos, API REST et workflows low-code |
Présentation du projet
ChapsVision développe des solutions de data intelligence pour des environnements complexes et hautement sécurisés.
Dans le cadre d'une mission de conseil de quatre mois, j'ai créé la première documentation d'ArgonOS, une plateforme de préparation, d'exploration et d'analyse des données. Mon travail a principalement porté sur le module Data Preparation, tout en couvrant également l'installation, l'administration, certains contenus liés aux API et les concepts essentiels de la plateforme.
Le projet a démarré sans documentation existante. J'ai donc dû comprendre directement le produit par l'exploration pratique, les échanges avec la R&D et une validation progressive avec les experts métier et techniques.
Contexte
ArgonOS était encore en évolution et aucun corpus documentaire structuré n'était disponible au début de la mission.
Le défi ne consistait donc pas à migrer ou réviser des contenus existants, mais à identifier ce que les utilisateurs devaient comprendre, formaliser les concepts et workflows du produit, et créer une structure documentaire complète dans un délai limité.
Comme la plateforme combinait administration technique, traitement des données, modules low-code et workflows utilisateurs complexes, la documentation devait favoriser à la fois la compréhension des concepts et l'adoption pratique de la solution.
Principaux livrables
Architecture documentaire et création des contenus
J'ai défini l'architecture documentaire et créé les contenus directement à partir du produit.
Mon approche combinait :
- des tests pratiques de l'application ;
- des entretiens et revues itératives avec la R&D ;
- l'identification de comportements peu clairs et d'informations manquantes ;
- la validation progressive des concepts, procédures et éléments de terminologie.
La documentation produite couvrait l'installation, l'administration, la configuration, l'utilisation de la plateforme, les concepts de Data Preparation et certaines informations liées aux API.
J'ai également créé un catalogue des modules low-code de l'application, fournissant une référence structurée sur leur finalité, leur configuration et leur utilisation.
Workflows utilisateurs et portail documentaire
Afin d'aider les utilisateurs à dépasser la compréhension des fonctionnalités isolées et à utiliser concrètement la plateforme, j'ai créé des tutoriels détaillés fondés sur des workflows complets de préparation des données.
Ces tutoriels combinaient procédures, captures d'écran, processus low-code, schémas et explications des résultats attendus.
J'ai proposé et mis en œuvre Docusaurus comme plateforme documentaire, avec Markdown et une approche docs-as-code. Le portail comprenait une navigation structurée, un moteur de recherche, des composants personnalisés et une identité visuelle cohérente avec le produit.
Un guide d'installation HTML autonome a également été produit pour une utilisation hors ligne.
Le portail final a été très bien accueilli par ses premiers utilisateurs et a fourni une base structurée aux rédacteurs techniques qui ont ensuite poursuivi l'effort documentaire.
Mon rôle
J'ai piloté le projet de la découverte du produit jusqu'à la publication, en combinant architecture documentaire, rédaction technique, conception de workflows utilisateurs, création de contenus visuels et mise en œuvre du portail documentaire.
La mission reposait largement sur ma capacité à prendre rapidement en main un produit technique inconnu, à transformer des connaissances produit implicites en contenus structurés et à travailler de manière autonome tout en maintenant une collaboration étroite avec la R&D.
Technologies et outils
Docusaurus, Markdown, Microsoft Azure Repos, Git, Sourcetree, Visual Studio Code, API REST, Redocusaurus, HTML, CSS, workflows low-code et Excalidraw.
Confidentialité
Le portail documentaire ArgonOS et ses contenus techniques sont confidentiels et ne peuvent pas être présentés publiquement.
Cette page décrit donc le périmètre, l'approche et l'expertise mobilisée sans divulguer d'informations produit propriétaires.
© Florence Venisse, Experte en Documentation Technique & IA – Version révisée le 21/07/2026.