Il archivio, il wiki e questa documentazione

Traduzione automatica dell'originale francese.

Tre luoghi, spesso confusi, che non servono allo stesso scopo. La domanda "Dove scrivo?" può essere risolta in una frase, ma merita di essere posta: una conoscenza collocata nel posto sbagliato non viene persa, ma semplicemente non è disponibile quando serve.

Cosa sono e a cosa servono

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 ? »"]

L'indicazione verso il wiki è continua: è automatica, nessuno la decide. Quella verso la documentazione è intermittente: presuppone qualcuno che rilegge, riscrive e decide cosa pubblicare.

L'archivio e il wiki hanno lo stesso volume, e questo non è un caso: il wiki riprende tutte le note versionate dell'archivio, escludendo quelle che un filtro di riservatezza elimina. Ciò che le distingue non è il contenuto, ma l'uso.

	Archivio	Wiki	Questa documentazione
Natura	Memoria di lavoro	Archivio consultabile	Manuale d'uso
Alimentato	Continuamente, durante l'azione	Derivato dall'archivio, ogni notte	Manualmente, quando si stabilizza
Volume	≈ 5.100 note	≈ 5.100 pagine	25 pagine
Riletta?	No	No	Sì
Tempo	Datata — "il 24 agosto…"	Datata	Attuale — "in questo modo"
Si apre per	Scrivere	Trovare	Fare

Il test che risolve

La formulazione breve

Questa documentazione risponde a domande che si possono porre prima di conoscere il parco. Il wiki risponde a domande che presuppongono che lo si conosca.

La domanda	Il luogo
« Come posso pubblicare un servizio? »	Documentazione
« Perché docs ha impiegato 40 minuti il 30 agosto? »	Wiki
« Dove si trova il file Compose per uno stack? »	Documentazione
« Quali decisioni sono state prese su LightRAG? »	Wiki
« Quale porta SSH per vm-docker? »	Documentazione
« Cosa è andato storto durante la migrazione di Headscale? »	Wiki

Corollario utile: una pagina di questa documentazione che contiene una data è probabilmente una nota di wiki mascherata. Le date sono valide per qualificare una misurazione ("registrato il 2026-08-27"), ma non per raccontare una storia.

E i circa 1.700 FAQ?

Rimangono nel vault, e quindi nel wiki. Non hanno il loro posto qui, per motivi di natura, non di volume.

Una sezione FAQ è un documento datato e specifico: nasce da un evento, contiene i risultati di un'indagine, afferma "questo è ciò che abbiamo ritenuto, questo è ciò che abbiamo misurato, questo è ciò che era sbagliato". Questo resoconto è prezioso, ed è del tipo "wiki".

Ciò che merita questa documentazione è la regola che la sezione FAQ contiene: senza l'indagine, e presentata in modo che chi ne ha bisogno possa trovarla facilmente.

Nella sezione FAQIci (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.

Non, non è una "FAQ da copiare qui": è una regola da estrarre e da applicare nella pagina relativa.

Perché entrambi sono privati

Entrambi sono legati ad Authentik, ed è intenzionale.

Il valore di questa documentazione risiede proprio nel fatto che la rende inaccessibile: gli indirizzi esatti, le porte, i percorsi, il fatto che l'edge sia un NAS. Una versione "pulita" di tutto ciò non sarebbe più un manuale d'uso — ma solo un testo generico, che nessuno di noi avrebbe motivo di leggere.

La materia realmente pubblicabile esiste, ma non è un terzo sito

Alcune informazioni che possiamo trovare qui non contengono indirizzi e sono valide per tutti:

• acme.sh si attiva in codice 0 quando l'installazione del certificato fallisce;
• un act_runner ha un ambito unico, e le esecuzioni queued non sembrano errori;
• un filtro DNS anti-bypass può bloccare lo strumento che emette i certificati;
• un tema di documentazione può smettere di visualizzare i suoi diagrammi senza scrivere una singola riga di errore.

Si tratta di materiale per un articolo, non per un altro sito da mantenere. Il punto in comune di questi quattro merita di essere scritto una volta per tutte: sono malfunzionamenti che non si annunciano.

In sintesi

1. Si scrive nel vault mentre si lavora — sempre, senza chiedere.
2. Il wiki si aggiorna da solo. Non c'è bisogno di fare nulla.
3. Si promuovono qui le informazioni che si sono stabilizzate e che possono aiutare qualcuno ad agire — riscrivendo, mai copiando.

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