En résumé
Le wiki est la documentation de l’équipe, rangée en arborescence de pages écrites en Markdown. Il sert à consigner ce qui ne tient ni dans le code ni dans les données : conventions, protocoles, dictionnaires de variables, comptes rendus. Des modèles évitent la page blanche, et une page peut être marquée vérifiée pour distinguer ce qui fait foi.
À quoi sert un wiki dans Linkr
Un entrepôt de données s’accompagne toujours d’un savoir qui ne s’y trouve pas. Pourquoi telle variable est inexploitable avant 2019. Comment le service définit une réadmission. Quelle procédure suivre avant de publier.
Ce savoir circule d’ordinaire par oral, par courriel, ou dans un document que personne ne retrouve. Le wiki lui donne un endroit, à côté des données qu’il décrit plutôt que dans un outil séparé.
L’arborescence
Les pages s’organisent en arbre : une page peut contenir des sous-pages, qui peuvent elles-mêmes en contenir. C’est ce qui permet de garder un wiki lisible quand il grandit — un chapitre par grand sujet, le détail en dessous.
Chaque page reçoit une icône, qui aide à repérer d’un coup d’œil la nature d’une section dans l’arbre.
Chercher plutôt que naviguer
Au-delà de quelques dizaines de pages, on ne parcourt plus l’arbre : on cherche. Ctrl + K ouvre la recherche depuis n’importe où dans le wiki.
Les modèles
Créer une page propose un modèle, qui pose d’emblée une structure adaptée au type de document :
- Procédure (SOP) — une marche à suivre, étape par étape.
- Dictionnaire de données — la description des variables d’une source.
- Onboarding — ce qu’un nouvel arrivant doit lire en premier.
- Notes de réunion, FAQ, Protocole d’étude, Article — ou une page vide si rien ne convient.
L’intérêt n’est pas de gagner quelques minutes de mise en forme, mais d’obtenir des documents comparables : deux procédures écrites à six mois d’intervalle se ressemblent, donc se lisent plus vite.
Écrire une page
Le contenu s’écrit en Markdown, avec quelques blocs utiles au-delà du texte courant : des encadrés pour signaler un avertissement ou un point d’attention, et des blocs repliables pour ranger un détail sans l’effacer.
Chaque page affiche la date de sa dernière mise à jour — souvent la première chose à regarder avant de faire confiance à une documentation.
Les pages vérifiées
Une page de wiki vieillit. Celui qui la lit ne sait pas toujours si elle décrit encore la réalité.
Une page peut donc être marquée vérifiée : quelqu’un l’a relue et en confirme le contenu. C’est une distinction utile entre une note écrite au fil de l’eau et une page qui fait référence.
Un usage typique
Le dictionnaire des variables de l’entrepôt est marqué vérifié après chaque revue annuelle. Les notes de réunion, elles, ne le sont jamais — elles datent leur propre contenu.
Pour aller plus loin
- Vue d’ensemble — ce que l’espace de travail regroupe autour du wiki.
- Catalogue de données — pour documenter les variables elles-mêmes, plutôt que les procédures.