Documentation technique
Écrire pour que la relève puisse suivre
Des transmissions, procédures d'exploitation et manuels qui permettent à votre équipe de faire fonctionner le système sans rappeler ses concepteurs.
Une sélection de réalisations illustrant cette prestation.

Photo : jessica45 / Pixabay 
Photo : stevepb / Pixabay
Transformez la prestation en résultat
Mettez « Documentation technique » au service d'un résultat pour votre entreprise. Nous pouvons relier le travail technique aux utilisateurs, aux opérations et aux décisions qu'il doit soutenir. Des transmissions, procédures d'exploitation et manuels qui permettent à votre équipe de faire fonctionner le système sans rappeler ses concepteurs.
Examinez les réalisations pertinentes
Consultez les réalisations liées sur cette page pour examiner notre démarche. Interrogez-nous sur les compromis et les conditions qui ont conduit à chaque résultat. Un plan d'infrastructure pour 14 départements — 14 départements de recherche sur un même plan d'infrastructure
Un plan d'infrastructure pour 14 départements Contactez-nous
-
Un plan d'infrastructure pour 14 départements
Conçu un cadre d'infrastructure complet pour un institut de recherche regroupant 14 départements, avec des modules flexibles, des pipelines de données unifiés et des stratégies d'accompagnement structurées pour une adoption durable.
-
8 projets Power BI et leurs manuels
Livré 8 projets Power BI accompagnés de manuels complets, intégrant les outils Microsoft Power BI à une API NodeJS et à Python FastAPI pour l'analyse et la visualisation des données.
-
50 000 mots de documentation logicielle
Rédigé 50 000 mots de documentation logicielle complète en Markdown dans GitHub, Craft et Confluence pour conserver les connaissances et rendre le processus transparent.
-
Migration vers Huma v2 avec parité de 100 %
Migré l'API HTTP de Fiber vers Huma v2 — 649 chemins et 760 opérations — puis atteint et maintenu une correspondance de 100 % entre les routes enregistrées par le serveur et la description OpenAPI publiée.
-
578 cibles d'automatisation go‑task
Créé 578 cibles d'automatisation go‑task couvrant les modes de développement natif, Docker et HTTPS, les contrôles de code, les tests, la base de données et le déploiement.
-
Moteur de 268 contrôles pour le dépôt
Conçu le moteur de garde‑fous du dépôt — 268 contrôles de commit enregistrés, 277 règles de linting et 15 règles ESLint personnalisées — ainsi que 146 tests de ces garde‑fous, pour que les exigences soient appliquées par la compilation et non par la seule revue.
-
Programme continu d'analyse de sécurité
Mis en place un programme continu de sécurité — analyse du code, DAST, contrôles des dépendances et des vulnérabilités, génération de SBOM, détection de secrets et actions épinglées par SHA — accompagné de 21 audits de sécurité écrits.
-
7 rôles de reporting de l'hôte en lecture seule
Conçu sept rôles de reporting en lecture seule décrivant un hôte en service en Markdown — faits, accès, git, métriques, trafic, sécurité et inventaire fournisseur — selon une règle interdisant d'afficher un chiffre non mesuré pendant l'exécution.
-
Règle de périmètre après une fuite de secrets
Écrit une règle de périmètre dans le dépôt après qu'une restructuration y a introduit l'inventaire, les autorisations de pare‑feu et les textes d'une autre entreprise, en conservant les éléments mis en quarantaine dans le champ de la détection des secrets.
-
Contrôle avant commit avec 22 linters
Conçu un contrôle obligatoire avant commit composé de 22 linters tenant sur une ligne et de cinq nécessitant un paragraphe, sans niveau d'avertissement ni suppression locale autorisée, couvrant HTML, CSS, JavaScript, Python, YAML, Markdown, shell, liens, orthographe, secrets et typographie.
-
Développement piloté par 51 initiatives écrites
Piloté le développement du site à travers 51 initiatives écrites dans 54 documents de planification, chacun conservant ses points ouverts, ses mesures et les décisions écartées, dont six des huit constats de préparation aux agents refusés avec justification consignée.
-
Documentation soumise à son propre linter
Soumis la documentation à son propre linter — budget de lignes par fichier ne pouvant que diminuer, obligation d'index et contrôle de l'existence des chemins — qui a trouvé six plans sur neuf déclarés terminés avec des cases non cochées et quatorze tâches obligatoires avant commit absentes des documents.
-
106 contrôles sur 106 du profil PDF/UA‑1 réussis
Consigné la validation PDF/UA‑1 de neuf documents avec 106 vérifications sur 106 réussies dans le profil d'accessibilité configuré, tandis que la variante d'archivage échouait sur une règle parmi 146.
-
Divergences entre hooks et contrôle qualité
Découvert que les hooks de commit et le contrôle qualité exécutaient des vérifications différentes alors qu'un document les disait identiques, en comparant les deux listes dans un test : les cinq contrôles seulement lancés à la main étaient ceux qui lisaient les textes du CV.
-
Contrôle des chiffres entre langues
Conçu un contrôle multilingue échouant quand une traduction omet un chiffre présent en anglais ou utilise une notation étrangère à sa langue, révélant deux descriptions danoises privées d'une mesure et seize passages ukrainiens utilisant les guillemets anglais.
-
Parseur vérifiant chaque appel FFI
Écrit un parseur lisant le véritable en‑tête C de 7 308 lignes et vérifiant chaque site d'appel, chaque constante d'énumération et le caractère final de toute classe propriétaire de pointeurs, après qu'un en‑tête de substitution manuscrit a laissé compiler et lier des appels à trois fonctions supprimées, puis provoqué un plantage.
-
Erreurs réécrites sans blâmer les utilisateurs
Réécrit les messages d'erreur de l'application selon une charte de ton après qu'un refus de connexion reprochait une faute de frappe à l'utilisateur alors que le fournisseur exigeait un mot de passe d'application, avec un test nommant ce fournisseur.
-
Une norme d'historique pour 4 dépôts
Appliqué à quatre dépôts une même norme d'historique — commits conventionnels, sans emojis ni mention d'attribution, imposés par un hook de message de commit — et 48 documents d'instructions régissant le travail.
-
Six collecteurs indiquent les entrées ignorées
Fait expliciter à six collecteurs de reporting la partie de leurs entrées jamais lue — fichiers non ouverts, sondes non installées, lignes du journal non reconnues — et ajusté les seuils sur 116 échantillons mesurés, après avoir établi qu'une collecte aveugle et un hôte sain produisaient la même page.

