El repositorio, la wiki y esta documentación

Traducción automática del original francés.

Tres lugares, a menudo confundidos, que no sirven para lo mismo. La pregunta "¿dónde lo escribo?", se puede responder en una frase, pero merece ser formulada: un conocimiento almacenado en el lugar incorrecto no se pierde, simplemente no se encuentra cuando se necesita.

Lo que cada uno es

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 flecha hacia la wiki es continua: es automática, nadie la decide. La flecha hacia la documentación es puntuada: asume que hay alguien que la lee, la reescribe y decide qué se debe publicar.

El repositorio y la wiki tienen el mismo volumen, y esto no es una coincidencia: la wiki recopila todas las notas versionadas del repositorio, excepto las que un filtro de confidencialidad elimina. Lo que las diferencia no es el contenido, sino el uso.

	Repositorio	Wiki	Esta documentación
Naturaleza	Memoria de trabajo	Archivo consultable	Manual de instrucciones
Alimentado	Continuamente, durante la acción	Derivado del repositorio, cada noche	Manualmente, cuando se estabiliza
Volumen	≈ 5 100 notas	≈ 5 100 páginas	25 páginas
Se lee?	No	No	Sí
Tiempo	Fechado — "el 24 de agosto…"	Fechado	Actual — "Así lo hacemos"
Se abre para	Escribir	Encontrar	Hacer

La prueba que decide

La formulación corta

Esta documentación responde a preguntas que se pueden hacer antes de conocer el parque. La wiki responde a preguntas que asumen que ya lo conocemos.

La pregunta	El lugar
"¿Cómo publico un servicio?"	documentación
"¿Por qué docs tardó 40 minutos en salir el 30 de agosto?"	wiki
"¿Dónde se encuentra el archivo Compose de un stack?"	documentación
"¿Qué habíamos decidido sobre LightRAG?"	wiki
"¿Qué puerto SSH para vm-docker?"	documentación
"¿Qué falló durante la migración de Headscale?"	wiki

Corolario útil: una página de esta documentación que contiene una fecha probablemente es una nota de wiki disfrazada. Las fechas son válidas para calificar una medición ("registrado el 27-08-2026"), pero nunca para narrar.

Y las aproximadamente 1.700 preguntas frecuentes

Siguen en el repositorio, y por lo tanto en el wiki. No tienen cabida aquí tal como están, por razones de naturaleza, no de volumen.

Una sección de preguntas frecuentes es un documento específico y contextualizado: surge de un incidente, refleja la investigación realizada, y establece "esto es lo que creíamos, esto es lo que hemos medido, esto es lo que era incorrecto". Este relato es valioso, y es de tipo wiki.

Lo que merece esta documentación es la regla que contiene la sección de preguntas frecuentes: sin la investigación, y presentada de forma que alguien pueda consultarla cuando la necesite.

Dentro del archivo (sección de preguntas frecuentes)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.

No es "una sección de preguntas frecuentes para copiar aquí": es una regla que se debe extraer y formular en la página correspondiente.

¿Por qué ambas son privadas

Ambas pertenecen a Authentik, y esto es intencional.

El valor de esta documentación reside precisamente en lo que la hace inaccesible: las direcciones exactas, los puertos, las rutas, el hecho de que el "edge" sea un NAS. Una versión eliminada de todo esto ya no sería un manual de instrucciones — solo un texto genérico, del que nadie aquí tendría razón para leer.

El contenido realmente publicable existe, pero no es un tercer sitio

Algunas verdades descubiertas aquí no contienen ninguna dirección y son válidas para cualquiera:

• acme.sh se muestra con el código 0 cuando falla la instalación del certificado;
• un act_runner tiene un alcance único, y las ejecuciones queued no se parecen a un error;
• un filtro DNS anti-evasión puede bloquear la herramienta que emite los certificados de la casa;
• un tema de documentación puede dejar de mostrar sus diagramas sin escribir ninguna línea de error.

Esto es contenido para un artículo, no para otro sitio web que mantener. De hecho, el punto común de estos cuatro merece ser escrito una vez para siempre: son fallos que no se anuncian.

En resumen

1. Se escribe en el repositorio mientras se trabaja — siempre, sin dudar.
2. El wiki se actualiza automáticamente. No hay nada que hacer.
3. Se promueve aquí lo que se ha estabilizado y que ayudará a alguien a actuar — reescribiendo, nunca copiando.

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