Aller au contenu

SOCLE / Infra & déploiement

Confluence

La doc partagée, pas le cimetière de pages

01 · Solution

La solution technique

Confluence quand le SI est déjà Atlassian. Par défaut, la doc utile vit dans le dépôt (Markdown, README, consignes). Confluence complète — il ne remplace pas la source de vérité.

Utile pour le métier qui ne lit pas le repo. Inutile si ça devient un Drive parallèle : on recentre alors sur le dépôt.

02 · Fiche

Confluence : ce que c’est

Confluence est un wiki d’équipe : pages, espaces, décisions, runbooks. Chez iD, le dépôt est la source de vérité. Confluence sert à ce qui doit rester lisible hors du code — pas à dupliquer le métier ailleurs.

La doc utile : architecture en une page, liens vers les critères et le repo, consignes de run. Le reste, on le coupe.

03 · Fiche

Pourquoi on l’utilise (selon le projet)

On s’y branche quand le client y range déjà la connaissance, ou quand plusieurs métiers doivent valider sans ouvrir le repo. Sinon : README + Markdown dans le dépôt — centralisé, versionné, transmis avec le code.

Même règle que pour le reste du socle : l’outil suit le besoin et l’existant. On ne crée pas un espace Confluence « parce que c’est Atlassian ».

04 · Fiche

Quand c’est le bon choix — et quand on passe

Bon choix pour la transmission métier (audit → build → run) quand Confluence est déjà le standard. On nomme un propriétaire de page, on archive le mort, on lie vers le dépôt.

On passe si personne ne lit Confluence, ou si la doc technique vit mieux à côté du code. Honnêteté : une page morte coûte plus qu’elle ne rapporte — on recentre sur le repo.

05 · Fiche

Ce que ça change pour vous

Vous gardez une mémoire accessible sans disperser la vérité du livrable. Code + doc courte + consignes : dans le dépôt d’abord ; Confluence en complément si c’est votre standard. Le Brief 45 min tranche le bon support.

Next · Loading

Un outil qui coince ?

Un Brief de 45 minutes, gratuit. On clarifie le périmètre — puis un audit build si ça tient la route.

STATUS: READY SIGNAL: OPEN WHOAMI → BRIEF
Réserver un Brief 45 min