Acklio (ThingPark)
Rédactrice Technique Senior Freelance — Documentation pour développeurs
Éléments clés
| Catégorie | Données |
|---|---|
| Organisation | Acklio, ensuite intégré à ThingPark |
| Période | D'octobre 2021 à octobre 2022 |
| Domaine | IoT, télécommunications, SCHC, LPWAN, LoRaWAN et IP |
| Rôle | Rédactrice technique senior freelance |
| Périmètre | Architecture documentaire, contenus développeur, schémas, mise en œuvre du portail et mises à jour itératives |
| Publics | Développeurs, intégrateurs, partenaires et experts en télécommunications |
| Langue | Anglais |
| Environnement | Docusaurus, Markdown, GitLab, Sourcetree, Excalidraw et ReDoc |
Présentation du projet
Acklio était une entreprise française spécialisée dans les télécommunications et l'IoT, pionnière et contributrice à la création de SCHC, le standard permettant de relier des réseaux LPWAN contraints à des systèmes fondés sur IP.
Au cours de plusieurs phases successives de conseil, j'ai créé le premier portail documentaire structuré d'Acklio, puis je l'ai maintenu et enrichi dans le cadre du Developer Program de l'entreprise.
La documentation s'adressait à un public très technique et couvrait les fondamentaux des protocoles, les fonctionnalités des produits, les intégrations de dispositifs et des cas d'usage concrets dans des environnements SCHC, LPWAN, LoRaWAN et IP.
Contexte
Les connaissances techniques d'Acklio étaient réparties entre Confluence, des dépôts GitLab, des spécifications internes, les sources produit et les contributions de la R&D.
Le défi consistait à comprendre un environnement télécom inconnu et très spécialisé, à rapprocher ces sources hétérogènes et à les transformer en une documentation précise et accessible pour des utilisateurs experts.
La documentation devait également poser les bases conceptuelles de SCHC avant de présenter les produits Acklio et de montrer comment les mettre en œuvre dans des scénarios IoT concrets.
Principaux livrables
Architecture documentaire et contenus développeur
J'ai suivi un processus d'onboarding intensif combinant l'analyse de sources internes, la recherche sur les standards de télécommunication, l'exploration des logiciels et des échanges réguliers avec la R&D.
J'ai ensuite conçu l'architecture documentaire autour de trois piliers complémentaires :
- les fondamentaux des protocoles et des technologies ;
- les fonctionnalités des produits Acklio et les conseils de mise en œuvre ;
- les cas d'usage concrets et les scénarios d'intégration de dispositifs.
Cette structure permettait aux lecteurs de progresser des principes de SCHC et des communications LPWAN jusqu'à la configuration des produits et à leur mise en œuvre dans des situations réelles.
Afin de faciliter la compréhension de concepts abstraits, d'architectures, d'échanges de messages et de workflows, j'ai créé plus de 100 schémas techniques originaux avec Excalidraw.
Portail documentaire et mises à jour continues
J'ai proposé et mis en œuvre Docusaurus comme socle du premier portail documentaire structuré d'Acklio, intégré à son Developer Program.
Le workflow docs-as-code fondé sur Markdown et GitLab permettait de gérer la documentation aux côtés des sources techniques, avec des branches, des revues et des contributions traçables.
Lors de plusieurs phases de mise à jour ultérieures, j'ai enrichi et révisé le portail afin de prendre en compte :
- les nouvelles versions et fonctionnalités des produits ;
- l'évolution des sources techniques ;
- des dispositifs et intégrations supplémentaires ;
- de nouveaux cas d'usage développeur ;
- les retours et validations de la R&D.
Cette approche itérative a transformé le projet documentaire initial en une ressource développeur maintenable et capable d'évoluer avec le produit.
Mon rôle
J'ai piloté le processus documentaire depuis l'acquisition des connaissances et la conception de l'architecture jusqu'à la rédaction, la mise en image des concepts, l'implémentation du portail et les mises à jour successives liées aux versions.
La mission m'a demandé d'assimiler rapidement des concepts télécom complexes et de les traduire en contenus structurés, précis et pédagogiques, sans simplifier à l'excès des informations destinées à des lecteurs experts.
Technologies et outils
Docusaurus, Markdown, GitLab, Git, Sourcetree, Excalidraw, Visual Studio Code, ReDoc, HTML, CSS et JavaScript.
Documentation publique
À la suite de l'intégration d'Acklio dans l'écosystème ThingPark, la documentation est désormais accessible publiquement.
Consulter la documentation ThingPark X SCHC IPCore
© Florence Venisse, Experte en Documentation Technique & IA – Version révisée le 21/07/2026.