📍 Article principal du cluster : BookStack 2026 : guide complet.
Sans structure planifiée, BookStack devient un fouillis après 6 mois. Ce tutoriel détaille l’architecture validée chez plusieurs PME francophones : shelves par grand domaine, books par sujet, chapters par étape.
Prérequis
- BookStack en production.
- Compréhension besoins documentation entreprise.
- Niveau attendu : intermédiaire.
- Temps estimé : 1-2 heures planification.
Architecture par type d’entreprise
SaaS B2B
- Shelf « Public Documentation » : Books par feature.
- Shelf « Internal Engineering » : Books par stack.
- Shelf « Onboarding » : Books par rôle.
- Shelf « Procédures » : Books par processus.
Cabinet juridique
- Shelf « Procédures Internes ».
- Shelf « Modèles & Templates ».
- Shelf « Veille Juridique ».
- Shelf « Onboarding ».
ESN/Agence digitale
- Shelf par client (privé).
- Shelf « DevOps Runbooks ».
- Shelf « Process Internes ».
- Shelf « Connaissance Tech ».
Étape 1 — Créer shelves
Sidebar → Shelves → Create new shelf. Pour chacun :
- Name descriptif.
- Description claire.
- Cover image.
- Tags :
internal,public,tech.
Étape 2 — Books par sujet
Dans shelf Engineering, books typiques :
- Déploiement Production.
- Stack Frontend.
- Stack Backend.
- Bases de données.
- Monitoring.
- Incident Response.
Étape 3 — Chapters par étape
Book « Déploiement Production » → chapters :
- 1. Préparation du VPS.
- 2. Configuration DNS.
- 3. Coolify setup.
- 4. CI/CD.
- 5. Monitoring post-deploy.
Étape 4 — Pages : action concrète
Chapter « Préparation du VPS » → pages :
- Acheter VPS Hetzner CX22.
- Configurer SSH key et UFW.
- Mises à jour automatiques.
- Monitoring Uptime Kuma.
Étape 5 — Templates de pages
# Titre procédure
## Contexte
[Pourquoi cette procédure existe]
## Prérequis
- Item 1
- Item 2
## Étapes
1. Étape 1
2. Étape 2
## Vérification
[Comment vérifier]
## Erreurs courantes
[Issues fréquentes]
## Liens
- [Page liée](url)Étape 6 — Tags et metadata
Tags par page : aws, postgres, incident, onboarding. Filtrable search.
Étape 7 — Cross-references
BookStack support liens internes auto. Taper [ ouvre suggestion pages. Maillage fluide.
Étape 8 — Page sommaire
Première page de chaque book = sommaire des chapters. Aide navigation.
Étape 9 — Reviews trimestrielles
Tous les 3 mois, relire sections. Pages obsolètes archivées. Évite drift.
Étape 10 — Search optimal
- Titres descriptifs.
- Premier paragraphe résume.
- Tags pertinents.
Erreurs fréquentes
| Erreur | Cause | Solution |
|---|---|---|
| Trop de profondeur | Hierarchy 5+ | Garder 4 max |
| Pages dupliquées | Pas de search avant | Always search |
| Permissions chaotiques | Custom roles partout | 3-4 rôles standard |
| Tags inconsistents | Free-text | Liste tags officiels |
| Doc orpheline | Pas de review | Quarterly review |
Adaptation au contexte ouest-africain
Trois précisions. Multi-langues : pour PME bilingue FR/AR, shelves séparés. Onboarding : shelf dédié avec book par rôle. Compliance : shelf « Conformité ARTCI/CDP ».
Tutoriels frères
FAQ
Pages max ? CX22 = 50k confortable.
Réorganiser ? Drag-drop reorder. Liens auto-update.
Templates ? Mark as template, réutilisable.
Versioning ? Toute édition crée version.
Doc public partiel ? Public role + shelf privé/public.
Pour aller plus loin
- 🔝 Retour au pilier : Guide complet BookStack 2026