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