Buenas prácticas de control de versiones de documentos
Buenas prácticas de control de versiones de documentos para equipos con un esquema de numeración: mantenlo estable, fija dónde aparecen versión, fecha y aprobador, evita ediciones en paralelo, y registra cada revisión sin cambios.
Las buenas prácticas de control de versiones de documentos son los hábitos que mantienen fiable un esquema de numeración existente a lo largo de años de rotación de personal y de volumen, en lugar de las reglas para elegir el esquema en primer lugar.
En resumen
- Mantén el esquema de numeración estable una vez elegido: renumerar rompe toda referencia cruzada que citara el número antiguo.
- Imprime versión, fecha y aprobador en el mismo sitio fijo de cada página, no solo en el nombre del archivo o en las propiedades.
- Nunca dejes que dos personas editen la versión «vigente» en paralelo sin una convención de bloqueo o de reserva.
- Decide de antemano, por escrito, qué hace que un cambio sea mayor frente a menor.
- Trata «no se necesitan cambios» como un resultado de revisión registrado, no como silencio.
- QueryChart sustituye la convención de reserva por un único diagrama vivo y canónico. Ver /features/version-control.
Un esquema solo es tan bueno como su segundo año
Un esquema de numeración rara vez falla en su primer mes. Falla en su segundo año, cuando la persona que fijó «números enteros para copias emitidas» se ha marchado, un nuevo controlador de documentos inventa una regla ligeramente distinta para resolver un caso urgente, y dos convenciones empiezan a correr a la vez por el mismo registro. Esta página da por hecho que la decisión básica ya está tomada (elegir un esquema en primer lugar está cubierto en /es/guides/como-controlar-versiones-de-un-documento) y trata de los pocos hábitos que mantienen en funcionamiento un esquema ya elegido cuando le llegan de verdad el volumen, la rotación de personal y la urgencia.
Cuatro cosas se tuercen después de elegir el esquema, y ninguna tiene que ver con el esquema en sí. Renumerar una biblioteca existente para corregir un defecto percibido rompe toda referencia cruzada, registro de formación y cita de auditoría anterior que nombrara los números antiguos, así que suele costar más que convivir con el defecto. Un número de versión que solo vive en un nombre de archivo o en un panel de propiedades desaparece en el momento en que alguien imprime una página o reenvía una captura, así que necesita en su lugar una posición fija e impresa. Que dos autores editen el mismo archivo «vigente» en la misma tarde no es en absoluto un problema de numeración: es una convención de bloqueo o de reserva que falta, y ningún esquema sobrevive sin una. Y una revisión periódica que no encuentra ningún error igual tiene que dejar rastro, o es indistinguible un año después de una revisión que nunca ocurrió. Nada de esto es el ciclo de vida completo del documento (de la solicitud a la baja se recorre entero en /es/templates/proceso-de-control-de-documentos) es la capa de numeración dentro de ese ciclo de vida, hecha bien en lugar de solo hecha.
QueryChart elimina uno de estos modos de fallo de forma estructural en lugar de mediante política. Hay un único diagrama vivo y canónico por documento en lugar de un conjunto de archivos que alguien tiene que acordarse de bloquear, cada guardado se captura automáticamente como una entrada nueva en el registro de cambios con el autor y el campo exacto que cambió, y Comparar versiones pone dos revisiones cualesquiera una junto a otra. Dos personas no pueden bifurcar en silencio la copia «vigente», porque solo hay una, y todo su historial es una consulta en lugar de un ejercicio de memoria. Ver /features/version-control.
Dónde aparecen estas prácticas en la vida de un documento
El mismo diagrama de control de versiones de documentos de 18 filas, leído por lo que hace que su esquema de numeración se sostenga en lugar de por los propios pasos de numeración.
El esquema empieza antes de que nadie revise nada
«Asignar versión de borrador inicial 0.1» ocurre inmediatamente después de «Nuevo documento redactado», antes de «Circular el borrador para revisión interna» o «El revisor evalúa el borrador»: el esquema decimal se fija en la fila dos, no se inventa a mitad de la primera decisión «¿Se requieren cambios?».
La corrección incrementa, nunca renumera
«Incrementar la versión menor» y «Corregir el borrador según los comentarios» vuelven a la revisión por una rama etiquetada «Nueva revisión» antes de «Enviar el borrador final para aprobación» y «El aprobador revisa el borrador final»: la misma regla decimal se sostiene en cada pasada, así que citar el borrador 0.3 sigue nombrando una única copia exacta.
Una decisión traza la línea entre mayor y menor
«¿Aprobado para emisión?» es la única fila con una ruta a un número entero: la rama Aprobado llega a «Asignar versión mayor 1.0», mientras que Rechazado vuelve a «Incrementar la versión menor»; después «Actualizar el registro del historial de versiones», «Publicar la versión aprobada» y «Marcar la versión anterior como obsoleta» fijan esa decisión en una fila de tipo File antes de que nadie lea la copia nueva.
Un documento que no necesita cambios aún recibe una marca
«¿Se solicita un cambio tras la publicación?» se responde incluso cuando la respuesta es No: esa rama termina en «La versión actual sigue en vigor», un resultado nombrado en vez de una ausencia de actividad, mientras que Sí reabre el documento en «Reabrir el documento en la siguiente versión» en lugar de arrancar una segunda copia en paralelo.
Cómo funciona
Congela el esquema de numeración en cuanto dependan de él documentos reales
Trata un cambio en el propio esquema (pasar de números enteros a versionado semántico, o redefinir qué significa un decimal) como un proyecto, no como un ajuste: invalida toda referencia cruzada existente, todo registro de formación y toda cita de auditoría anterior. Si aparece un defecto, documenta la excepción de ahí en adelante en lugar de renumerar la biblioteca.
Pon versión, fecha y aprobador en un único sitio fijo de toda plantilla
Elige una única posición (encabezado o pie) e incorpórala en la plantilla del documento para que cada autor la use sin decidir. Un número de versión en un nombre de archivo o en las propiedades del documento no sobrevive a una impresión, una captura de pantalla o un reenvío por correo; uno impreso en la página sí.
Dale a la versión «vigente» una convención de bloqueo o de reserva
Decide quién puede tener abierta para edición la versión vigente a la vez, y cómo se entera un segundo autor de que alguien ya la tiene: un indicador de reserva en el registro, un archivo bloqueado, o una única copia viva y canónica donde solo puede ganar un guardado a la vez. Sin esto, dos ediciones aprobadas que caen sobre la misma versión no es una hipótesis.
Escribe la regla de mayor frente a menor antes de que la necesite el primer documento
Especifica, en el mismo documento que define el esquema de numeración, exactamente qué dispara el salto de número entero (la aprobación formal sola, o la aprobación más una reescritura sustancial). Un equipo que lo decide caso por caso acaba con dos documentos distintos, ambos llamados versión 2.0.
Registra toda revisión periódica, incluidas las que no cambian nada
Dale al paso de revisión forma de decisión con una salida etiquetada «sin cambios» que escriba una entrada fechada en el registro, del mismo modo que «¿Se solicita un cambio tras la publicación?» llega a «La versión actual sigue en vigor» en lugar de limitarse a no hacer nada. Una entrada que falta debería significar que la revisión no ocurrió, no que no pasó nada durante ella.
Deja que una única copia viva y canónica elimine el problema de bloqueo por completo
Abre el documento como un diagrama de QueryChart en lugar de un conjunto de archivos que circulan por correo, y solo hay una versión vigente que editar: cada guardado se captura como una entrada nueva en el registro de cambios automáticamente, así que una convención de reserva ya no tiene nada que hacer cumplir. Ver /features/version-control.
Errores que debes evitar
Renumerar para corregir un error
Descubrir dos años después que el esquema tiene un defecto y renumerar todo el registro para corregirlo rompe toda cita que nombrara los números antiguos: auditorías, registros de formación, referencias cruzadas en otros documentos. Documenta en su lugar la excepción de ahí en adelante; convive con el defecto en lo ya emitido.
El número de versión que solo vive en el nombre del archivo
«Politica_v3_FINAL.docx» no le dice nada a nadie en cuanto se imprime, se reenvía o se copia sin su nombre. Pon la versión, la fecha y el aprobador dentro del propio documento, en el mismo sitio fijo cada vez.
Dos copias «vigentes» editadas en la misma tarde
Una copia en una unidad compartida y una copia enviada por correo se editan como si cada una fuera la maestra, y los dos conjuntos de cambios se sobrescriben en silencio o bifurcan. Arregla esto con una convención de reserva o, mejor, con una única copia viva y canónica. Ver /features/version-control.
Una revisión que no deja rastro cuando no cambió nada
Un documento revisado y encontrado todavía exacto, sin ninguna entrada registrada en ningún sitio, es indistinguible un año después de un documento que nadie revisó. Dale a «no se necesitan cambios» su propia línea fechada en el registro, del mismo modo que la rama No de una fila de decisión sigue llegando a un resultado nombrado.
Aplica estas prácticas a tu propio documento
Abre el ejemplo de control de versiones de documentos como diagrama propio, y deja que una única copia viva y canónica más un registro de cambios automático lleven por ti las reglas de esta página.
Guías relacionadas
Preguntas frecuentes
¿Cuál es el mayor error de control de versiones de documentos que hay que evitar?
Tratar el esquema como fijo solo hasta que alguien encuentre un motivo para cambiarlo. Renumerar una biblioteca existente (incluso para corregir un defecto real) rompe toda referencia cruzada, registro de formación y cita de auditoría que nombrara los números antiguos, y ese coste casi siempre supera el de convivir con un esquema imperfecto. Corrige los problemas de ahí en adelante con una excepción documentada, no tocando lo ya emitido.
¿Cómo evito que dos personas editen la misma versión «vigente» a la vez?
O añades una convención de reserva explícita (un indicador en el registro que muestra quién tiene el documento abierto, para que un segundo autor sepa que debe esperar) o eliminas la posibilidad estructuralmente manteniendo exactamente una copia viva y canónica en lugar de archivos que circulan por correo o por una unidad compartida. QueryChart hace lo segundo: cada documento es un único diagrama vivo, cada guardado se versiona automáticamente, y no hay una segunda copia que pueda bifurcar. Ver /features/version-control.
¿Qué debería contar como versión mayor frente a menor?
No hay una regla universal, que es justo por lo que hay que escribirla antes de que la necesite el primer documento en lugar de juzgarla caso por caso. Una convención habitual ata el salto de número entero, mayor, únicamente a la aprobación formal (cada revisión de borrador intermedia, por sustancial que sea, se queda en decimal), así que «cuán grande fue el cambio» nunca hay que discutirlo en el momento de asignar un número de versión.
¿Hay que registrar una revisión periódica que no encontró cambios necesarios?
Sí: una revisión sin registrar es indistinguible de una revisión que nunca ocurrió. Dale al paso de revisión de tu proceso forma de decisión con una salida etiquetada para «sin cambios necesarios» que aun así escriba una entrada fechada en el registro, del mismo modo que la fila de decisión de un diagrama registra toda rama que toma, no solo las que llevan a algo nuevo.
