Conception et planification 3D
🏢 Présentation du client
3DVIA, une marque du groupe Dassault Systèmes, propose une suite d’outils de modélisation et de visualisation 3D conçus pour améliorer l’expérience utilisateur dans des secteurs tels que l’aménagement intérieur, le commerce de détail et l’industrie.
Ses solutions incluent des plateformes comme HomeByMe, qui permet aux consommateurs et aux professionnels de créer des plans d’intérieur 3D réalistes, et 3DVIA Composer, utilisé pour produire de la documentation produit interactive et des illustrations techniques.
En combinant des interfaces de conception intuitives avec un accès cloud, 3DVIA aide les entreprises à rationaliser leurs flux de travail, personnaliser l’engagement client et accélérer la prise de décision grâce à des environnements immersifs en 3D.
📇 Éléments clés
| Catégorie | Données |
|---|---|
| Client | 3DVIA, Dassault Systèmes |
| Période du projet | Hiver 2019 - 2020 |
| Langue | Anglais |
| Outils et frameworks | Docusaurus 1.x |
| Approche | Méthodologie docs-as-code |
| Expertise | Markdown et générateurs de sites statiques (SSG) |
| Mode de collaboration | Collaboration directe (Montreal Associates pour la facturation et le paiement) |
🧩 Présentation du projet
Le travail a porté sur la documentation des applications destinées aux concepteurs de cuisines : "Home By Me for Kitchen Retailers".
Cela a d’abord impliqué la rédaction d’une documentation de base dans Word pour les professionnels de la conception de cuisines, puis la migration d’une documentation HTML existante vers un framework moderne docs-as-code avec Docusaurus v1, tout en réécrivant et en enrichissant le contenu pour améliorer la clarté, l’utilisabilité et la maintenabilité.
Rédaction initiale dans Word
J’ai commencé par rédiger un guide complet dans Microsoft Word, destiné aux professionnels concevant des meubles de cuisine avec la suite d’applications 3DVIA. Cette documentation expliquait comment utiliser l’éditeur de géométrie, les outils d’assemblage, l’interface base de données et le planificateur orienté client dans un flux de travail coordonné.
Pour garantir clarté et pertinence :
- J’ai simulé l’ensemble du processus de création d’un meuble de cuisine de A à Z.
- Je me suis mise dans la peau de différents utilisateurs – concepteurs, assembleurs, planificateurs – pour refléter les usages réels.
- J’ai produit des captures d’écran et des schémas détaillés pour illustrer chaque étape.
Ce guide a servi de référence de base pour les équipes internes et les partenaires externes.
Voir la documentation "Base Cabinet" sur Kitchen Tutorial / Base Cabinet
Migration vers Docusaurus v1
Suite à la documentation initiale sous Word, j’ai dirigé la migration vers un site Docusaurus v1 :
- Définition de l’architecture documentaire et du workflow de publication.
- Conversion du contenu Word et HTML existant en Markdown.
- Conseil auprès des collaborateurs sur la syntaxe Markdown et les bonnes pratiques de rédaction technique.
- Collaboration étroite avec les équipes en France et en Inde pour assurer cohérence et alignement.
Enrichissement du contenu & développement de tutoriels
En parallèle de la migration, j’ai réécrit et enrichi plusieurs sections :
- Réalisation de revues éditoriales approfondies pour restructurer et clarifier le contenu existant.
- Création de nouveaux schémas et mise à jour des captures d’écran pour refléter les workflows actuels.
- Développement du tutoriel transversal "Base Cabinet".
- Garantie que le contenu s’adresse à la fois aux publics techniques et métier.
Tout le contenu a été rédigé en Markdown avec Visual Studio Code, optimisé pour une intégration fluide dans le framework Docusaurus.
Documentation d'API
Entre les phases de rédaction technique et de migration, j’ai effectué une revue partielle de la documentation OpenAPI.
👩💻 Mon rôle
En tant que consultante expérimentée et rédactrice technique senior, j’ai été chargée de la documentation de base des outils de conception de cuisine 3DVIA – en rédigeant un guide professionnel depuis zéro pour les concepteurs de meubles utilisant la suite HomeByMe. J’ai mené le processus éditorial de manière autonome, de la rédaction à l’illustration, en simulant des workflows réels pour garantir un contenu pertinent, utilisable et didactique.
Avant ce projet, j’avais une solide expérience avec Hugo et j’étais déjà reconnue comme experte des workflows de documentation basés sur Markdown. Cette expertise a fait de moi le choix idéal pour diriger la migration des contenus HTML et Word vers un site Docusaurus v1. C’était ma première utilisation de Docusaurus, et ce projet a marqué un tournant, car Docusaurus est devenu depuis mon framework de prédilection.
Ce fut aussi une immersion complète dans la méthode docs-as-code, en collaboration avec d’autres utilisateurs sur différentes branches du dépôt GitTea.
🛰️ Technologies & Outils
Docusaurus, Markdown, Sourcetree, GitTea, Visual Studio Code, Jira, Microsoft Word.
Ressources créées dans les applications HomeByMe.
🔗 Lien vers le site final
Le site est désormais en version Docusaurus v3.
Voir en particulier la documentation "Base Cabinet" sur Kitchen Tutorial / Base Cabinet