Cómo crear un historial de revisiones de un documento
Cómo construir un historial de revisiones: las columnas que necesita, por qué el registro es un artefacto separado y de solo añadido respecto al documento que describe, y el paso de verificación que casi toda tabla se salta.
Cómo funciona
Separa el registro del documento
Pon el historial de revisiones en su propio artefacto (una tabla en la portada o un registro independiente), nunca como un párrafo enterrado en el cuerpo. El documento cambia; el registro es el único de los dos al que se le permite solo crecer.
Fija las columnas antes de la primera entrada
Número de versión, fecha, autor, una descripción sencilla de qué cambió y por qué, una referencia a la versión que sustituye, y quién verificó la entrada. Omite cualquiera de las dos últimas y no hay forma de distinguir un registro comprobado de un autoinforme.
Abre la entrada antes de la edición, no después
Registra una entrada pendiente (número, enlace al documento, autor asignado) en el momento en que se aprueba un cambio, antes de que nadie abra el archivo. Una entrada escrita después de los hechos se reconstruye de memoria, que es justo el modo de fallo que un registro existe para prevenir.
Anota qué cambió, no que algo cambió
«Se actualizó la sección 4» no es una descripción; «se cambió el umbral de aprobación de 500 $ a 2.000 $ en la sección 4» sí lo es. Registra el antes y el después en términos sencillos, el nombre del autor y la fecha, para que un lector pueda reconstruir el cambio sin abrir el propio historial de versiones del documento.
Verifica la entrada contra la edición real
Haz que alguien distinto del autor compare la descripción registrada con lo que realmente cambió en el documento antes de cerrar la entrada. Si no coinciden, averigua si el documento o la entrada están equivocados: corregir la entrada no siempre es un retroceso para el autor.
Muestrea entradas cerradas, no revises todas
Construye una auditoría periódica que compruebe una muestra de entradas cerradas contra sus documentos, en un calendario que pertenezca al programa de auditoría en lugar de a una comprobación improvisada. Esto es lo que hace que el registro sea algo en lo que puedes confiar sin volver a verificarlo tú mismo.
Preguntas frecuentes
¿Cuál es la diferencia entre un historial de revisiones y el control de versiones?
Un historial de revisiones es el artefacto: la tabla de versión, fecha, autor, descripción y verificador. El control de versiones es la práctica que mantiene honesta esa tabla: la regla de que nada se edita sin una entrada, de que las entradas nunca se reescriben después de los hechos, y de que alguien distinto del autor comprueba una contra la otra. Puedes tener un historial de revisiones con un control de versiones débil detrás: la tabla existe, pero nadie verifica jamás una fila contra la edición real.
¿Qué columnas necesita una tabla de historial de revisiones?
Número de versión, fecha, autor, una descripción sencilla de qué cambió y por qué, una referencia a la versión que sustituye y (la que más tablas hechas a mano se saltan) quién verificó la entrada contra la edición real. Una fila sin la última columna es el autoinforme de un autor, no un registro comprobado.
¿Debería editarse un historial de revisiones para corregir un error en una entrada antigua?
No. Añade una fila nueva que corrija el registro en lugar de reescribir la antigua; el registro solo es tan fiable como esté intacto su historial de solo añadido. Si lo equivocado fue el documento y no la entrada, la corrección pertenece a una nueva revisión del documento, no a una fila de registro reescrita.
¿Basta una hoja de cálculo llevada a mano para un historial de revisiones, o hace falta software?
Una hoja de cálculo funciona hasta que alguien edita una fila en lugar de añadir una, lo cual es difícil de prevenir y fácil de pasar por alto. El historial de versiones de QueryChart escribe automáticamente el registro equivalente: un registro de cambios con valores de antes y después por campo y el nombre de quien edita en cada revisión, visible en una pantalla de comparar versiones y restaurable en cualquier punto, en /features/version-control. El diagrama de arriba muestra la versión manual de la misma disciplina (una solicitud, una descripción archivada, un paso de verificación) sea cual sea la herramienta que la ejecute.