Buuk est une infrastructure de centre d’aide avec une porte éditoriale. Le contenu vit dans un workspace. Les éditeurs rédigent, organisent et relisent. Les clients ne voient que les pages publiées sur le site public, dans la recherche, dans Ask AI et dans le widget.
1. Un workspace est l’unité des docs
Chaque workspace a un nom, un slug, une identité, des membres et des collections. L’URL publique ressemble à app.getbuuk.com/help/your-slug. Sur Growth vous pouvez attacher un hostname custom comme docs.yourproduct.com.
Les owners et editors peuvent publier. Les viewers peuvent lire les brouillons dans le tableau de bord sans changer les pages en ligne.
2. Les collections structurent le site public
Un site docs complet (celui-ci) active cinq collections. Vous pouvez n’en activer qu’une partie dans Customise → site profile.
| Collection | Accueil éditeur | Onglet public |
|---|---|---|
| Documentation | Articles | Help |
| FAQ | FAQ | FAQ |
| Guides | Docs → Guides | Guides |
| Référence API | Docs → API Reference | API Reference |
| Changelog | Docs → Changelog | Changelog |
Les sections et dossiers vivent sous une collection. Les articles feuilles sont des pages. Les dossiers se replient dans la barre latérale pour qu’une longue nav reste scannable.
3. Brouillon, aperçu, puis publier
- Créez ou importez un article. L’enregistrement est automatique. L’historique de versions garde les snapshots précédents.
- Prévisualisez la mise en page publique depuis Help center preview. L’aperçu ne rend pas un brouillon public.
- Publiez quand le texte est prêt. L’URL reste stable tant que le slug ne change pas.
- Optionnel : planifier une heure de publication, ou exiger une approbation éditoriale avant d’envoyer.
Le travail non publié est hors recherche publique, widget et Ask AI pour les lecteurs. Traitez les brouillons comme internes jusqu’à la publication.
4. L’IA est un assistant d’écriture, pas l’éditeur
Ask Buuk dans le tableau de bord peut rédiger un article, réécrire une section ou vous pointer vers les réglages. Les mises à jour suggérées transforment tickets, fils Slack, releases GitHub, issues Linear, recherches manquées et retours « pas utile » en liste de relecture.
Accept applique ou ouvre un brouillon. Modifiez avant de publier. Dismiss si la doc est déjà juste. Buuk ne publie jamais une suggestion tout seul.
5. Le centre d’aide public est la surface client
- Recherche dans les articles publiés
- Réponses IA optionnelles ancrées dans ces articles, avec citations
- Feedback utile / pas utile sur chaque page
- Réactions et commentaires du changelog (pas de login Buuk)
- Widget optionnel avec recherche, chat, annonces et voix
6. L’analytics ferme la boucle
Les rapports montrent vues et recherches. Les recherches manquées et les questions Ask AI sans réponse deviennent des mises à jour suggérées. Doc health et Freshness marquent les pages minces, périmées ou non vérifiées pour que vous sachiez quoi réécrire.
Une semaine type
- Livrer le produit — L’app change. Releases GitHub, tickets et questions Slack arrivent comme d’habitude.
- Relire les suggestions — Ouvrez Suggestions. Acceptez celles qui doivent devenir de la doc. Laissez le reste.
- Éditer et publier — Réécrivez dans l’éditeur. Vérifiez Preview. Publiez. Freshness et la recherche rattrapent ce que vous avez manqué.
Vous regardez cette boucle tourner sur Buuk lui-même. Ouvrez n’importe quel article depuis Articles dans le tableau de bord pour modifier ce texte.