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

# Absorber una versión nueva del workflow

Usa esta guía cuando una versión nueva ya está publicada, ha habido un revamp o
alguien ha hecho una tanda de cambios a mano en la plataforma, y la
documentación tiene que ponerse al día.

Esto no es una release. Una release cambia el sistema y tiene su propia guía en
[Preparar y cerrar una release](/method/how-to/release). Aquí el cambio ya
ocurrió y lo que falta es describirlo sin afirmar más de lo comprobado.

## Qué clase de material es

Lo que llega es un **conjunto de afirmaciones técnicas por verificar**, y
conviene nombrarlo así porque no encaja en las dos entradas que ya existen. No
es conocimiento de negocio, así que no entra por
[el inbox](/method/how-to/inbox). No es una fuente, porque una fuente es un
documento que el cliente entrega y que no se edita.

Da igual quién lo escriba. Una nota de la persona que hizo el cambio, un
resumen automático del diff entre dos versiones y el acta de una sesión de
limpieza valen lo mismo: mientras no se haya leído el sistema vivo, ninguna de
sus frases es un hecho.

El conjunto es material de trabajo. Vive fuera del árbol publicado, con su
origen y su fecha, y se descarta cuando termina la verificación, porque lo que
valía ya está en las páginas.

## Procedimiento

### 1. Anclar la versión

Comprueba cuál es la versión viva y quédate con su identificador explícito. La
última versión y la viva no son la misma cosa, y sin el identificador la
lectura devuelve la versión editable. El detalle está en
[Actualizar el índice operativo](/method/how-to/sync).

### 2. Partir el conjunto en una lista

Una afirmación por línea, cada una con el nodo o el componente al que toca. Un
resumen en prosa no es una lista de verificación hasta que se parte.

### 3. Verificar afirmación a afirmación

Comprueba cada una contra la versión anclada: el nodo, sus herramientas y los
componentes que carga. Cada afirmación termina en uno de los tres estados de
[Procedencia y vigencia](/reference/source-map): verificado, por confirmar o no
encontrado.

### 4. Cruzar contra las decisiones cerradas

Una versión nueva puede haber ido en dirección contraria a algo que su
responsable ya decidió. Ese cruce no lo hace nadie más, así que hazlo aquí.

### 5. Reportar las contradicciones

Antes de escribir ninguna página. Una contradicción que se resuelve mientras se
redacta desaparece del registro sin que nadie la haya decidido.

### 6. Reescribir solo las páginas que cambian

Y solo esas. Una versión nueva no obliga a reescribir el caso entero.

### 7. Regenerar el índice y validar

Actualiza el índice operativo con la lectura y pasa el criterio de
[Validar una publicación](/method/how-to/publish).

## Precedencia cuando el conjunto y una decisión discrepan

Gana la decisión, pero antes comprueba que la decisión existe. Que una página
llame «acordado» a un camino no lo convierte en una decisión cerrada: si no
puede citar su fuente, lo que hay es un borrador con buena presentación, y
aplicarle precedencia propaga el error en lugar de corregirlo. Una decisión sin
fuente citable se trata igual que el conjunto de cambios: por confirmar.

Con la decisión sostenida por su fuente, gana ella. La divergencia se anota como
trabajo de plataforma, no como una corrección de la documentación. Escribir la
página hacia lo que el sistema hace hoy borra la única señal de que el sistema
está mal.

Eso no impide describir el sistema tal como está. Cuando lo que discrepa es el
estado técnico y no la regla, la página cuenta lo que el sistema hace y la regla
decidida queda marcada como no aplicada. Las dos cosas caben en la misma página.
Lo que no cabe es elegir una y callar la otra.

## Qué vuelve a «por confirmar»

Una versión que sube devuelve a **por confirmar** todo lo que se afirmó leyendo
la anterior: reglas, conteos, nombres de herramientas y composición de
componentes. No se reescribe la documentación entera en cada subida, pero
tampoco se defiende una lectura vieja como si fuera de hoy. Lo que se cite lleva
la versión y la fecha de la lectura que lo sostiene, y se recomprueba el día que
se toca ese nodo.

Lo mismo aplica a un componente: si sube de versión, la regla que gobierna
vuelve a «por confirmar» en todos los nodos que lo cargan.

## Detenerse

Detén la absorción si:

* la versión viva no puede confirmarse, o la lectura devuelve la editable;
* el conjunto de cambios no se puede partir en afirmaciones comprobables;
* una regla depende de un componente cuyo cuerpo no se ha podido leer, y se
  pretende darla por vigente de todas formas;
* una contradicción se resolvería eligiendo la versión que suena mejor.