NotionBASE DE CONNAISSANCES
Prérequis
- Espace Notion équipe avec permissions par rôle (dev, lead, PM)
- Accord sur la stack documentée (Next.js, CMS, hébergeur)
- Liste des décisions récentes à formaliser (ADR en attente)
- Lien vers les dépôts Git et les rules Cursor du projet
Quand la connaissance vit dans Slack ou dans la tête des seniors, chaque onboarding coûte des jours. Une base Notion centralise décisions, patterns et procédures pour que l'équipe retrouve l'information en quelques secondes. Vous allez définir une arborescence stable, des templates ADR et des règles de contribution adaptées à une agence multi-projets.
Définir l'arborescence et les templates
Créez une page racine « Wiki technique » avec sommaire. Branches principales : Onboarding, Stack (frameworks, CMS, CI/CD), ADR et Playbooks opérationnels.
Template ADR : Contexte, Options, Décision retenue, Conséquences, Date et auteurs. Numérotez (ADR-001, ADR-002) pour la traçabilité.
Ajoutez un glossaire client et une sous-page « Projet [Client] » par mission, liée au wiki global.
Rédiger pour la recherche et l'action
Titres explicites avec mots-clés métier (« Déployer sur Vercel — projet Next.js » plutôt que « Procédure »). Une idée par bloc ; listes numérotées pour les procédures.
Liez les rules Cursor (`.cursor/rules/`), les issues GitHub et les tutoriels internes. La recherche Notion (`Ctrl+K`) devient l'entrée unique.
Pour chaque pattern récurrent, une fiche courte : quand l'utiliser, exemple de code, pièges connus.
Gouvernance et contribution
Toute décision structurante (stack, auth, cache) génère un ADR sous 48 h. Les PR significatives peuvent exiger un lien ADR ou une mise à jour playbook.
Permissions : édition réservée aux devs ; PM en commentaire sur les pages cadrage. Indexez les ADR en base Notion (statut : proposé, accepté, déprécié).
Revue trimestrielle : supprimez les pages orphelines, fusionnez les doublons, mettez à jour versions de dépendances.
Erreurs fréquentes
Dupliquer la doc Next.js officielle au lieu de renvoyer vers `node_modules/next/dist/docs/` pour les APIs instables.
Mélanger doc client et doc interne sans permissions : risque de fuite d'infos sensibles.
Pas de template ADR : les décisions se perdent dans les threads Slack.
Titres génériques (« Notes », « Divers ») : la recherche Notion ne remonte rien d'utile.
Ce qu'il faut retenir
Wiki transverse : onboarding, stack, ADR, playbooks, glossaire.
Template ADR numéroté pour chaque décision structurante.
Liens vers repos, rules Cursor et tutoriels — recherche Notion = entrée unique.
Owner par section et revue trimestrielle pour éviter la doc pourrie.
FAQ
README pour le minimal viable (install, build, test). Notion pour le contexte transverse, les ADR et les procédures multi-dépôts ou multi-clients.
Créez une page « Rules projet » listant chaque fichier `.mdc` avec son objectif et un lien vers le dépôt. Mentionnez-les dans l'onboarding dev.
Le lead technique ou un référent rotatif. Chaque auteur d'ADR met à jour sa fiche tant que la décision est active.
Cursor
ChatGPT