> **Can't find what you're looking for?** Use `search_docs` on the docs MCP server at `https://naturgy-comer-documentation-p5mde.vercel.app/api/mcp` to find what you need.

# Prácticas obligatorias

Estas reglas se aplican a cualquier actualización de la documentación. La
[metodología documental](/method/explanations/documentation-methodology) explica
el ciclo completo y [Documentar en este repositorio](/method/how-to/documentation)
lo convierte en pasos ejecutables.

## Un hecho, una página propietaria

Cada hecho vive en una única página canónica. Las demás páginas enlazan con ella.
Una regla que afecta a varias capacidades tiene una explicación propia y un
estado claro.

## Verificar antes de afirmar

El estado técnico se escribe a partir de una lectura directa de la fuente que
manda. Una reunión, una nota o la memoria de una persona son material por
confirmar hasta que se contrastan. Conserva los estados **verificado**, **por
confirmar** y **no encontrado**.

## Mantener la precedencia explícita

Una regla que matiza otra debe nombrarla y describir su frontera. No dupliques
una prohibición en varias páginas ni uses mayúsculas para simular prioridad.
Cuando dos fuentes difieren, registra la contradicción y asigna su resolución al
responsable correspondiente.

## Separar contrato e inventario

La documentación explica qué consigue el cliente, cuáles son los límites y cómo
se comprueba el resultado. Los cuerpos de instrucciones, credenciales, datos
personales y cargas confidenciales no forman parte de una página publicada.
Los inventarios temporales incluyen la fecha y la versión de la lectura.

## Escribir con seguridad

Las lecturas pueden documentarse sin modificar el sistema. Antes de una
escritura o una ejecución:

1. explica el recurso y el cambio;
2. indica el motivo y el alcance;
3. espera confirmación explícita;
4. usa una sola puerta de escritura durante la sesión;
5. registra el resultado y cualquier limitación.

## Cerrar con evidencia

Una página no está terminada porque tenga muchos párrafos. Está terminada cuando
otra persona puede encontrar su fuente, seguir el flujo principal, entender las
excepciones y distinguir lo vigente de lo pendiente.

La lista de comprobación de publicación está en [Validar una
publicación](/method/how-to/publish).