Control de versiones para documentación de procesos y mapas de proceso
Cómo se aplica el control de versiones a la documentación de procesos (procedimientos, instrucciones de trabajo y mapas de proceso) y por qué un diagrama desactualizado desorienta a quien hace el trabajo, no solo al lector.
El control de versiones para documentación de procesos significa dar a procedimientos, instrucciones de trabajo y mapas de proceso el mismo identificador, revisión, ubicación autorizada e intervalo de revisión que cualquier otro documento controlado, más un requisito añadido: un diagrama desactualizado hay que retirarlo del punto de uso, no solo sustituirlo en un archivo.
En resumen
- Un mapa de proceso necesita los mismos cuatro controles que un procedimiento escrito: identificador y revisión, una única ubicación autorizada, retirada de la copia sustituida e intervalo de revisión fechado.
- Un paso añadido, un responsable reasignado o una rama de decisión reetiquetada es una revisión, aunque no haya cambiado ningún párrafo ni se haya movido el recuento de palabras.
- Un diagrama inspira más confianza que la prosa en el punto de uso, que es justo por lo que uno antiguo dejado en su sitio desorienta en vez de solo confundir.
- Rastrea quién cambió qué carril, fila o conector, compara dos versiones cualesquiera una junto a otra y restaura una anterior: el mismo historial de versiones que recibe un documento de texto.
- Retirar un diagrama sustituido significa encontrar cada impresión y cada copia incrustada, no solo sustituir el archivo en la ubicación autorizada.
Elegir herramientas de documentación
Un diagrama se sigue, no solo se lee
Un párrafo de un procedimiento se lee, después se interpreta y después se actúa sobre él: tres pasos separados en los que un lector puede sorprenderse a sí mismo fallando. Un diagrama de flujo colgado en un puesto de trabajo se salta directamente a actuar. Quien mira de reojo un mapa de proceso confía más en su forma que en una frase, porque un diagrama se lee como un hecho y no como el relato de alguien sobre un hecho, y esa confianza es justo lo que hace peligroso a un diagrama desactualizado: no solo confunde a quien lo lee, desorienta a quien está haciendo el trabajo mientras lo está haciendo.
La documentación de procesos (procedimientos, instrucciones de trabajo, mapas de proceso, matrices RACI) necesita las mismas cuatro cosas que necesita cualquier documento controlado: un identificador único y una revisión, una única ubicación autorizada, la retirada de la copia sustituida y una revisión periódica fechada. /es/guides/como-crear-un-proceso-de-control-de-documentos recorre todo el ciclo de vida en el que se asientan esas cuatro propiedades. Lo que cambia específicamente para un diagrama es más pequeño y fácil de pasar por alto: un paso añadido o eliminado, un responsable reasignado, una rama de decisión reetiquetada: ninguno de ellos toca un recuento de palabras, así que ninguno se lee como una revisión salvo que el proceso trate cada cambio de disposición como una.
Esta página se mantiene neutral respecto a la herramienta: la disciplina se sostiene tanto si el mapa vive en una herramienta de dibujo, en una página wiki o en un diagrama. /es/guides/control-de-versiones-de-diagramas-de-flujo cubre la versión más estrecha y específica del producto del mismo problema: qué registra un registro de cambios campo a campo en un diagrama de flujo real. Aquí, el recorrido de abajo usa el diagrama document-control-process de QueryChart porque es un ejemplo real y en funcionamiento de las cuatro propiedades, rastreado automáticamente por el historial de versiones descrito en /features/version-control.
Un mapa de proceso, recorrido etapa por etapa como documento controlado
El ciclo de vida del control documental usado como ejemplo práctico de un mapa de proceso bajo control de versiones: el mismo diagrama, desvelado carril a carril, desde el motivo del cambio hasta la fecha de revisión que lo reabre.
Una revisión empieza con un motivo, no con un redibujado
La fila de inicio, «Necesidad o cambio documental identificado», y la fila siguiente, «Abrir una solicitud de cambio documental», ocurren las dos antes de que nadie toque el diagrama en sí: para un mapa de proceso, el motivo del cambio tiene que registrarse exactamente igual que para un párrafo.
Redibujar es redactar
«Redactar o revisar el contenido» ahora incluye redibujar un paso, recolocar una rama de decisión o mover una caja a otro carril, y «¿Hay comentarios pendientes?» devuelve ese cambio de disposición a «Realizar la revisión técnica» de la misma forma que lo haría un comentario de redacción.
La versión asignada a un diagrama
El carril del Responsable documental asigna una versión y una fecha de vigencia, la escribe en «Actualizar el listado maestro de documentos», la publica y después ejecuta «Retirar del uso las copias obsoletas»: para un diagrama, ese paso de retirada significa el diagrama impreso pegado junto a la máquina, no solo el archivo de la unidad compartida.
Un diagrama en uso sigue teniendo fecha de revisión
La formación o «Leer y acusar recibo de la nueva versión» viene antes de «Usar la versión controlada vigente», y la revisión programada en «¿El documento sigue vigente?» le da al diagrama los mismos tres resultados que a cualquier documento controlado: «Vigente» registra la fecha, «Revisar» vuelve a la solicitud de cambio, «Retirar» termina en «Documento retirado y dado de baja».
Cómo funciona
Trata un cambio de disposición como una revisión
Una rama de decisión movida, un carril reasignado o un paso reetiquetado cambia lo que hace después un lector tanto como lo hace un párrafo reescrito. Da a tus mapas de proceso el mismo disparador de revisión que a tus procedimientos: cualquier cambio que altere lo que ocurre, no solo un cambio que altere lo que está escrito.
Pon la versión y la fecha en el propio diagrama
Imprime el identificador, el número de revisión y la fecha de vigencia en el diagrama, no solo en el nombre del archivo o en el registro que lo referencia. Alguien que mire el diagrama en una pantalla o en una impresión no debería tener que ir a buscar un registro aparte para saber si está vigente.
Mantén un único diagrama autorizado, y en todo lo demás un enlace
Cada copia incrustada en una wiki, un deck de formación o un paquete de proveedor debería enlazar a la versión autorizada en lugar de guardar una exportación pegada de ella. Una imagen pegada deja de actualizarse en el momento en que alguien la exporta.
Registra quién cambió qué fila, no solo que algo cambió
Un historial de diagrama útil nombra el campo: la etiqueta de esta caja, el destino de este conector, el orden de este carril, cambiado por esta persona en esta fecha. El registro de cambios de QueryChart registra exactamente eso automáticamente en cada diagrama, y Comparar versiones pone dos revisiones una junto a otra (ver /features/version-control).
Retira la copia impresa, no solo el archivo antiguo
Un diagrama de flujo pegado en un puesto de trabajo sobrevive al archivo del que se imprimió. Recorre los puntos de uso (tablones, puestos de máquina, paquetes de acogida) igual que lo harías con un procedimiento de texto, y sustituye o retira cada uno cuando se emite una revisión.
Errores que debes evitar
La impresión pegada
Un diagrama de flujo pegado con cinta junto a una máquina es el equivalente en diagrama de una impresión no controlada, y suele ser el primero que encuentra un auditor. Enumera los puntos de uso antes de emitir la siguiente revisión y sustituye la copia impresa en el mismo paso de retirada: el ciclo de vida completo, de la solicitud a la baja, está cubierto por entero en /es/templates/proceso-de-control-de-documentos.
Una rama de decisión reetiquetada sin registro de cambios
Renombrar «Aprobado» a «Aprobado con condiciones», o mover la rama Sí de una fila de tipo Decision a otro paso descendente, cambia el proceso sin cambiar una sola frase en ningún sitio. Si tu historial de versiones solo rastrea guardados de archivo, esa revisión es invisible.
Una exportación, muchas copias obsoletas
Un PNG o un PDF pegado en una página wiki o en un deck de formación es una instantánea, no un enlace: no se actualizará cuando lo haga el diagrama de origen. Cada sitio que referencie el mapa de proceso debería apuntar a la versión autorizada, no a un archivo que alguien exportó de una antigua.
Sin responsable para el diagrama, solo para el proceso
Un proceso puede tener un responsable nombrado mientras el mapa que lo representa no es de nadie en particular, que es cómo pasa tres reorganizaciones sin que lo toquen. Da al propio diagrama un revisor y una fecha de revisión, no solo al texto del procedimiento de al lado.
Crea tu propio mapa de proceso con control de versiones
Abre el ejemplo de control documental como diagrama propio, y cada fila, carril y conector que cambies a partir de ahora queda rastreado en su historial de versiones.
Guías relacionadas
Preguntas frecuentes
¿Es un mapa de proceso un documento controlado?
Sí, si lleva las obligaciones que lleva un documento controlado: un identificador y una revisión, un registro de aprobación, una única ubicación autorizada y un intervalo de revisión. El formato no decide la pregunta: un diagrama de flujo, una matriz RACI y un procedimiento escrito pueden ser todos documentos controlados, y un diagrama que se salta el control de versiones mientras el texto del procedimiento de al lado lo tiene no está en realidad controlado, solo parece ordenado.
¿Qué cuenta como cambio de versión en un mapa de proceso si no cambió ningún texto?
Un paso añadido o eliminado, un responsable reasignado a otro carril, una rama de decisión reetiquetada o redirigida, o el orden de dos pasos intercambiado son todos cambios de versión aunque no se reescribiera ninguna frase. La prueba es si el cambio altera lo que haría a continuación alguien que lee el diagrama: si lo hace, es una revisión, no un ajuste de formato.
¿En qué se diferencia esto del control de versiones para diagramas de flujo?
Esta página cubre la disciplina de versionado que necesita cualquier mapa de proceso, con independencia de la herramienta usada para dibujarlo. /es/guides/control-de-versiones-de-diagramas-de-flujo cubre el mismo problema desde dentro de un producto concreto: qué registra un registro de cambios campo a campo en un diagrama de flujo real, y cómo funcionan en la práctica Comparar versiones y restaurar.
¿Necesita la documentación de procesos el mismo control de versiones que un SOP de texto?
Sí: las cuatro propiedades, identificador y revisión, una única ubicación autorizada, retirada de la copia sustituida y una revisión fechada, se aplican con independencia del formato. Lo que difiere es solo el modo de fallo: un párrafo desactualizado confunde a un lector que tiene que interpretarlo, mientras que un diagrama desactualizado se sigue directamente, y por eso el paso de retirada importa todavía más para un mapa de proceso que para una página de prosa.