📍 Article principal : 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.
Prérequis
- BookStack en production.
- Niveau : intermédiaire.
- Temps : 1-2h planification.
Architecture par type 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
Pour chacun : name descriptif, description claire, cover image, tags internal / public.
Étape 2 — Books par sujet
Engineering shelf : Déploiement Production, Stack Frontend, Stack Backend, Bases de données, Monitoring, Incident Response.
Étape 3 — Chapters par étape
Book Déploiement → 1.Préparation VPS, 2.DNS, 3.Coolify, 4.CI/CD, 5.Monitoring.
Étape 4 — Pages action concrète
Chapter Préparation VPS → Acheter VPS Hetzner, Configurer SSH/UFW, Mises à jour auto, Monitoring Uptime Kuma.
Étape 5 — Templates de pages
# Titre procédure
## Contexte
## Prérequis
## Étapes
## Vérification
## Erreurs courantes
## LiensÉtape 6 — Tags metadata
Tags : aws, postgres, incident, onboarding. Filtrable search.
Étape 7 — Cross-references
Taper [ ouvre suggestion pages. Maillage fluide.
Étape 8 — Page sommaire
Première page de chaque book = sommaire chapters.
Étape 9 — Reviews trimestrielles
Tous les 3 mois, relire sections. Pages obsolètes archivées.
Étape 10 — Search optimal
- Titres descriptifs.
- Premier paragraphe résume.
- Tags pertinents.
Erreurs fréquentes
| Erreur | Cause | Solution |
|---|---|---|
| Trop profondeur | 5+ niveaux | Max 4 (shelf-book-chapter-page) |
| 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 review | Quarterly review |
Adaptation au contexte ouest-africain
Trois précisions. Multi-langues : shelves séparés FR/AR pour clarté. 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. Liens auto-update.
Templates ? Mark as template.
Versioning ? Toute édition crée version.
Doc public partiel ? Public role + shelf privé/public.
Pour aller plus loin
- 🔝 Pilier : Guide complet BookStack 2026