Aller au contenu principal
Documentation continue

Documenter en continu, de manière opposable

La documentation ne meurt plus le lendemain de la séance ARB. Wiki, ADRs, notices et DAS restent reliés entre eux et requêtables — pas un cimetière Confluence de plus.

Tech LeadSolutions ArchitectOnboarding lead
Wiki + Help
natifs intégrés
ADRs
structurées et requêtables
÷3
time-to-onboarding
Liaison auto
DAS ↔ notice ↔ ADR
Le problème

La documentation d'architecture vieillit mal. Le wiki Confluence devient un cimetière, les ADRs traînent dans GitHub sans index utilisable, les notices ARB dorment en PDF sur Drive. Six mois plus tard, on re-débat des mêmes décisions parce que personne ne se rappelle qu'elles ont déjà été tranchées.

1

Outils de doc disjoints

Confluence + GitHub + Drive. Chacun cherche dans 3 endroits différents.

2

Pas de lien décision ↔ code/archi

On peut lire une notice ARB sans savoir quel composant elle impacte aujourd'hui.

3

Pas de recherche cross-référentiel

Recherche full-text par outil seulement — pas de vue unifiée.

Conséquence concrète : Décisions re-débattues à l'identique 6 mois plus tard, onboarding architecte de 3 mois.

Notre approche

Comment Architecture Platform résout ça

Wiki natif (/wiki) couplé à un help center contextuel — un side panel qui s'ouvre depuis chaque écran avec les articles pertinents pour l'action en cours. Les ADRs portent une référence normalisée (ARCH-XXX-NNN), elles sont liées aux notices et aux DAS, et restent requêtables des années après. On ne cherche plus, on retrouve.

  • Documentation générée par les workflows. Chaque notice ARB produit une ébauche d'ADR pré-remplie.
  • Help center contextuel. Affiché là où c'est utile — l'utilisateur ne quitte pas son écran.
  • Référencement normalisé. Convention ARCH-{DOMAIN}-{TYPE}-{SEQ}. Searchable, citable.
Parcours dans le produit

4 étapes, de l'entrée à la décision

01

Notice ARB produit automatiquement une ébauche d'ADR

Référence ARCH-XXX-NNN + verdict + raisonnement.

02

L'ADR est complétée par le porteur

Et publiée dans le wiki — sans copier-coller manuel.

03

Le help center contextuel propose l'ADR

Depuis l'écran de l'application où elle s'applique. L'utilisateur ne cherche pas.

04

Recherche full-text cross-référentiel

Sur DAS, notices, ADRs, articles wiki — un seul champ de recherche.

app.arch-platform.com/das
DAS Documents — référentiel éditorial centralisé
DAS Documents — référentiel éditorial centralisé
app.arch-platform.com/das/DEMO-MDM
DAS — sections structurées avec verdicts par stakeholder
DAS — sections structurées avec verdicts par stakeholder
app.arch-platform.com/das/DEMO-ERP
DAS — section parties prenantes + impact
DAS — section parties prenantes + impact
app.arch-platform.com/das/DEMO-WMS
DAS — sections sécurité + RGPD + plan d'action
DAS — sections sécurité + RGPD + plan d'action
Bénéfices mesurables

Ce que vous gagnez concrètement

Cibles observées sur les équipes archi de 5 à 15 personnes — onboarding plus rapide, moins de réinventions.

÷3
time-to-onboarding
−80 %
décisions re-débattues
100 %
documentation à jour
Cross-réf
searchabilité
Fonctionnalités mobilisées

Sous le capot

W
Wiki natif intégré

/wiki accessible depuis toute la plateforme.

A
ADRs avec convention ARCH-XXX-NNN

Searchable, citable, versionnée.

H
Help center contextuel

Référence ARCH-HELP-CENTER-001 — side panel à la demande.

R
Recherche full-text

Cross-référentiel : DAS, notices, ADRs, wiki.

L
Liaison automatique

Notices ↔ ADR ↔ DAS — pas de doublon, pas d'oubli.

Vous pourriez aussi consulter

Cas d'usage liés

Voir Architecture Platform en action

30 minutes de démo personnalisée sur votre périmètre.