Le vault, le wiki et cette documentation¶

Trois endroits, souvent confondus, qui ne servent pas à la même chose. La question « où est-ce que j'écris ça ? » se tranche en une phrase, mais elle mérite d'être posée : une connaissance rangée au mauvais endroit n'est pas perdue, elle est simplement introuvable au moment où elle servirait.

Ce que chacun est¶

flowchart LR
    travail["Session de travail<br/>incident, décision, mesure"]

    subgraph vault["Vault Obsidian — la mémoire"]
        notes["≈ 5 100 notes<br/>incidents · decisions.md · faqs/"]
    end

    wiki["Wiki (Wiki.js)<br/>≈ 5 100 pages<br/>resynchronisé chaque nuit"]
    doc["Cette documentation<br/>25 pages<br/>écrite à la main"]

    travail -->|"en continu,<br/>pendant qu'on agit"| notes
    notes -->|"automatique<br/>miroir nocturne"| wiki
    notes -.->|"à la main,<br/>quand ça se stabilise"| doc

    wiki --> lire["Retrouver<br/>« que s'est-il passé ? »"]
    doc --> faire["Agir<br/>« comment je fais X ? »"]

La flèche vers le wiki est pleine : elle est automatique, personne ne décide. Celle vers la documentation est pointillée : elle suppose quelqu'un qui relit, réécrit, et tranche ce qui mérite d'être publié.

Le vault et le wiki ont le même volume, et ce n'est pas une coïncidence : le wiki reprend toutes les notes versionnées du vault, moins celles qu'un filtre de confidentialité écarte. Ce qui les distingue n'est pas le contenu, c'est l'usage.

	Vault	Wiki	Cette documentation
Nature	Mémoire de travail	Archive consultable	Mode d'emploi
Alimenté	En continu, pendant l'action	Dérivé du vault, chaque nuit	À la main, quand ça se stabilise
Volume	≈ 5 100 notes	≈ 5 100 pages	25 pages
Relu ?	Non	Non	Oui
Temps	Daté — « le 24 août… »	Daté	Présent — « on fait ainsi »
On l'ouvre pour	Écrire	Retrouver	Faire

Le test qui tranche¶

La formulation courte

Cette documentation répond à des questions qu'on peut poser avant de connaître le parc. Le wiki répond à des questions qui présupposent qu'on le connaît.

La question	L'endroit
« Comment je publie un service ? »	documentation
« Pourquoi `docs` a mis 40 minutes à sortir le 30 août ? »	wiki
« Où vit le fichier Compose d'un stack ? »	documentation
« Qu'est-ce qu'on avait décidé sur LightRAG ? »	wiki
« Quel port SSH pour vm-docker ? »	documentation
« Qu'est-ce qui a cassé pendant la migration Headscale ? »	wiki

Corollaire utile : une page de cette documentation qui contient une date dans son propos est probablement une note de wiki déguisée. Les dates y sont légitimes pour qualifier une mesure (« relevé le 2026-08-27 »), jamais pour raconter.

Et les quelque 1 700 FAQ ?¶

Elles restent dans le vault, et donc dans le wiki. Elles n'ont pas leur place ici telles quelles — pour une raison de nature, pas de volume.

Une FAQ est un objet daté et situé : elle naît d'un incident, elle porte son enquête, elle dit « voilà ce qu'on a cru, voilà ce qu'on a mesuré, voilà ce qui était faux ». Ce récit est précieux, et c'est du wiki.

Ce qui mérite cette documentation, c'est la règle que la FAQ contient — sans l'enquête, et posée là où quelqu'un en aura besoin.

Dans le vault (FAQ)Ici (règle)

« Une émission acme.sh échoue Timed out waiting for DNS parce qu'AdGuard bloque le résolveur DoH » — 90 lignes : le symptôme, les fausses pistes, les trois pièges enchaînés, ce qui a été essayé, la date.

Un encadré de dix lignes dans Publier un nouveau service, à l'étape du certificat : --dnssleep est obligatoire, voici la commande qui tranche, voici le correctif durable.

La règle opératoire

Une FAQ consultée deux fois est une page de documentation qui manque.

Pas « une FAQ à copier ici » : une règle à extraire, et à poser dans la page du geste concerné.

Pourquoi les deux sont privés¶

Les deux sont derrière Authentik, et c'est délibéré.

La valeur de cette documentation vient précisément de ce qui la rend impubliable : les adresses exactes, les ports, les chemins, le fait que l'edge soit le NAS. Une version expurgée de tout ça ne serait plus un mode d'emploi — juste un texte générique, que personne ici n'aurait de raison de lire.

La matière réellement publiable existe, mais ce n'est pas un troisième site

Certaines vérités découvertes ici ne contiennent aucune adresse et valent pour n'importe qui :

acme.sh sort en code 0 quand l'installation du certificat a échoué ;
un act_runner porte une portée unique, et des exécutions queued ne ressemblent pas à une erreur ;
un filtrage DNS anti-contournement peut bloquer l'outil qui émet les certificats de la maison ;
un thème de documentation peut cesser d'afficher ses diagrammes sans écrire une seule ligne d'erreur.

C'est de la matière d'article, pas d'un site de plus à maintenir. Le point commun de ces quatre-là mérite d'ailleurs d'être écrit une fois pour toutes : ce sont des pannes qui ne s'annoncent pas.

En résumé¶

On écrit dans le vault pendant qu'on travaille — toujours, sans se demander.
Le wiki suit tout seul. Rien à faire.
On promeut ici ce qui s'est stabilisé et qui aidera quelqu'un à agir — en réécrivant, jamais en copiant.

Dernière vérification de cette page : 2026-10-06