ADR-0009 · Centre d’aide comme hub public unique
Academy, guides, FAQ, dépannage et docs développeurs publiques partagent un seul hub afin d’éviter toute duplication.
Statut
Accepté — Pré-v1.
Contexte
ADR-0008 a correctement sorti Academy de Studio, mais lui a créé une surface documentaire racine séparée. Cela duplique la fonction du Centre d’aide et multiplie les destinations publiques sans augmenter la valeur utilisateur.
Le cockpit doit rester léger : il n’a pas vocation à embarquer une seconde copie des leçons, de MCP ou de l’API.
Décision
Le Centre d’aide devient le hub public unique :
/help-center
├── academy
│ ├── getting-started
│ ├── studio
│ ├── automate
│ └── workflows
├── guides
├── faq
├── troubleshooting
└── developers
├── mcp
└── api
Academy conserve son identité dans l’interface Orbit, mais son URL canonique est :
https://orbit.boostecom.dev/help-center/academy
Rôle de chaque catégorie
| Catégorie | Rôle |
|---|---|
| Academy | valeur immédiate, parcours guidés, workflows complets |
| Guides | accomplir une tâche précise |
| FAQ | répondre rapidement à une question |
| Dépannage | résoudre un incident |
| Développeurs | comprendre les surfaces publiques MCP/API |
Les contrats API draft, l’architecture interne, les secrets et runbooks restent protégés.
Conséquences app
La sidebar du cockpit peut proposer :
- Academy → Centre d’aide / Academy ;
- Docs → documentation publique ;
- MCP → Centre d’aide / Développeurs / MCP ;
- API → Centre d’aide / Développeurs / API.
Ces entrées sont des liens externes. Elles ne créent aucune section Studio interne.
Invariant
Une connaissance publique a une résidence canonique unique. Le cockpit ouvre la bonne page ; il ne la recopie pas.