> **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.

# Cómo proponer una actualización

Una actualización está lista cuando el lector puede encontrarla, entender su
alcance y distinguir los hechos comprobados de las preguntas abiertas.

## Preparar el cambio

1. Identifica el dominio propietario: `atc`, `operations`, `account`, `method`,
   `agent-guide` o un dominio estable futuro.
2. Decide la intención Diátaxis: `tutorial`, `how-to`, `explanation` o
   `reference`.
3. Busca una página canónica existente antes de crear otra.
4. Usa la [plantilla de caso de uso](/reference/template) cuando el tema sea
   un caso nuevo.
5. Define `audience`, `domain`, `diataxis`, `kind`, `status`, `keywords` y
   `description`.

El catálogo de agentes se genera a partir de esos metadatos; no se mantiene con
una copia manual.

## Revisar el contenido

Comprueba que:

* el primer párrafo explique el valor para el lector;
* los actores, sistemas, entradas y salidas estén nombrados;
* el camino principal y las excepciones estén documentados;
* cada hecho tenga un propietario canónico;
* las afirmaciones temporales incluyan fecha y alcance;
* las contradicciones queden visibles con su responsable;
* los acrónimos nuevos aparezcan en el [glosario](/reference/glossary);
* no haya credenciales, datos personales ni cargas confidenciales;
* los enlaces apunten a la ruta canónica.

## Revisar la navegación

La página debe aparecer desde su índice de sección. Si se mueve o cambia de
nombre, conserva una redirección para las rutas históricas. Comprueba también
que la etiqueta de audiencia no cree una copia paralela.

## Validar la publicación

Sigue [Validar una publicación](/method/how-to/publish). La comprobación debe
incluir metadatos, enlaces, búsqueda, tema claro/oscuro, redirecciones y el
índice legible por máquina.

Si la actualización también cambia el comportamiento de un workflow, no la
trates como una publicación documental: aplica la [metodología de releases](/method/explanations/release-methodology)
y registra el cambio con la [guía de release](/method/how-to/release).

## Criterio editorial

Usa frases completas y lenguaje claro. Define cada acrónimo en su primera
aparición. Prefiere una página corta con un propietario claro a una página que
mezcle tutorial, explicación y referencia.