Références de bloc
Un énoncé, une adresse — single source of truth
- Vous comprenez qu'un identifiant de bloc est une adresse UUIDv4 — un emplacement canonique, autant de citations ((id)) que voulu. ·· Critère de réussite : Vous expliquez la différence entre copie et référence sur un exemple de votre choix.
- Vous tranchez avec assurance entre ((id)) et intégration. ·· Critère de réussite : Vous classez correctement cinq cas — sauter vers le contexte vs rester dans le flux de lecture.
- Vous créez un Architecture Decision Record et le citez depuis trois pages. ·· Critère de réussite : Une modification de l'ADR apparaît de façon synchrone dans les trois citations.
Les identifiants de bloc sont des UUIDv4. Une définition, une adresse. ((id)) la cite partout. La charge de maintenance lors d'une modification de définition baisse de 95 %, parce que vous éditez exactement un bloc et 14 emplacements restent synchronisés.
Le copier-coller entre les pages engendre de la dérive
Une définition migre par Ctrl+C dans 14 pages. Six mois plus tard, la définition change. Vous corrigez un emplacement, vous en oubliez 13. La cohérence entre définition et usage tombe sous les 50 %, sans que vous le remarquiez.
- Symptôme de dérive 1 : deux pages se contredisent, et les deux semblent plausibles.
- Symptôme de dérive 2 : la recherche de « ICP » renvoie 14 occurrences avec 4 définitions différentes.
- Symptôme de dérive 3 : personne ne sait quelle version fait foi — alors on en rédige une nouvelle. Et voilà la quinzième.
5 règles pour les références de bloc
- Un UUIDv4 par bloc. Chaque bloc reçoit un identifiant dès sa création, p. ex. 6c1b9a2e-4f3d-47a1-9e10-c0b7e2a55f12. Stable, sans collision, jamais à deviner.
- Référence de bloc ≠ intégration de bloc. ((id)) crée un lien — le bloc reste visible à son emplacement d'origine. {{embed ((id))}} reflète — le bloc apparaît en ligne à l'endroit de la citation.
- La syntaxe ((id)). Doubles parenthèses, l'UUID entre les deux, sans espace. L'autocomplétion se déclenche dès la saisie de ((.
- Source unique vs miroir. La définition vit à un seul endroit (la source). Tous les autres emplacements sont des miroirs via ((id)). Éditer le miroir = éditer la source.
- L'ADR comme cas d'usage de référence. Les Architecture Decision Records sont la source naturelle : formuler la décision une seule fois, puis la référencer dans la roadmap, l'onboarding, le post-mortem via ((id)).
## ADR-007: Block-IDs sind UUIDv4
id:: 6c1b9a2e-4f3d-47a1-9e10-c0b7e2a55f12
Wir verwenden UUIDv4 für Block-IDs, weil:
- kollisionsfrei ohne zentrale Vergabe
- 122 Bit Entropie reichen für 10^36 Blöcke
- offline generierbar (crypto.randomUUID())
---
## Roadmap Q3
Siehe Entscheidung: ((6c1b9a2e-4f3d-47a1-9e10-c0b7e2a55f12))
## Onboarding für neue Devs
ID-Schema: ((6c1b9a2e-4f3d-47a1-9e10-c0b7e2a55f12))Avant/après — 14 clones Wikipédia vs un seul bloc, intégré 14 fois
| Avant | Après |
|---|---|
| 14 pages avec la définition d'ICP copiée | 1 bloc, 14 références via ((id)) |
| Édition à 14 emplacements, 13 oubliés | Édition à 1 emplacement, 14 emplacements synchronisés |
| Recherche « ICP » → 14 occurrences, 4 versions | Recherche « ICP » → 1 source, 14 rétroliens |
| Dérive inaperçue, contradictions dans le wiki | Dérive structurellement exclue |
| La charge de maintenance croît avec les usages | Charge de maintenance constante, quel que soit le nombre d'usages |
<!-- Source-Block (lebt in /glossar/icp.md) -->
id:: a8e2d710-3b9f-4c25-8d6a-1f2e7b3c4d50
ICP (Ideal Customer Profile): Beschreibung des Konto-Typs, der mium am stärksten profitiert — Branche, Größe, Wissensvolumen, Compliance-Frame.
<!-- Verwendung in /sales/playbook.md -->
Unser ICP: ((a8e2d710-3b9f-4c25-8d6a-1f2e7b3c4d50))
<!-- Verwendung in /onboarding/woche-1.md -->
Lies zuerst: ((a8e2d710-3b9f-4c25-8d6a-1f2e7b3c4d50))
<!-- Verwendung in /roadmap/2026.md -->
Fokus 2026: ((a8e2d710-3b9f-4c25-8d6a-1f2e7b3c4d50))Question franche
Combien de fois avez-vous dû maintenir la même définition à des emplacements différents ? Comptez les endroits où « Client », « Lead » ou « Terminé » est défini dans votre wiki. Si le nombre dépasse 1, au moins l'un d'eux est déjà obsolète.
Un énoncé, une adresse. Tout le reste n'est que miroir.
- Prenez une définition qui vit en plusieurs copies dans votre wiki — par exemple « ICP », « Terminé » ou « Client ». Choisissez un emplacement comme source, donnez un identifiant à ce bloc et remplacez chaque autre copie par ((id)). Modifiez ensuite la source une fois et vérifiez que toutes les citations suivent.⏱ 5 min
💡 Recherchez d'abord le terme et comptez les occurrences — la liste vous montre quel emplacement doit devenir le canonique et combien de copies vous dissolvez.
Solution : Quatorze emplacements copiés deviennent un bloc source avec un identifiant plus treize citations ((id)). La modification de la source apparaît aussitôt dans toutes les citations — la charge de maintenance passe de quatorze emplacements à éditer à un seul. Ce qui constitue une véritable décision, vous le portez en plus dans un ADR et le citez depuis là via ((id)).
Qu'advient-il de quatorze citations ((id)) lorsque vous modifiez le bloc source ?
Un énoncé. Une adresse.
Bâtissez votre connaissance pour qu'une modification se propage partout — votre deuxième cerveau tient les fils ensemble.
Réserver mon créneau··gratuit →