Cómo comparar versiones de documentación cripto
Un proceso para registrar cambios de instrucciones, interfaz y advertencias.
Este artículo puede contener enlaces de afiliados. Las relaciones comerciales se detallan en la política de afiliados.
La documentación de un proyecto cripto cambia más rápido que el propio proyecto. Comparar dos versiones de esa documentación es una tarea de verificación, no de lectura. Una guía puede describir un flujo que ya no existe y seguir pareciendo válida, porque el texto continúa siendo claro. Lo que caducó no se anuncia.
Comparar dos versiones sirve para responder una pregunta concreta: qué cambió, cuándo cambió y qué parte de mi flujo depende de ese cambio.
Empieza por la fecha, no por el contenido
Un documento sin fecha es un documento sin prioridad. Antes de leer nada, busca la fecha de publicación o de última actualización. Si no existe, el documento no se puede situar en el tiempo y cualquier comparación parte de una suposición.
Busca también un registro de cambios o un enlace al historial de versiones. Una documentación que mantiene ese registro permite comparar con precisión. Una que no lo mantiene solo te deja comparar el texto actual contra lo que recuerdas.
Separa lo que sigue vigente de lo que cambió de lugar
Un cambio de interfaz mueve pasos sin cambiar el objetivo. Un cambio de mecanismo cambia lo que ocurre en la red y sí invalida lo que tenías anotado. Un cambio de advertencia puede ser el más importante de los tres, porque lo que antes era opcional ahora puede ser obligatorio.
Clasifica cada diferencia en una de esas tres categorías antes de decidir si te afecta.
Una diferencia de dirección no es una diferencia de riesgo
Si dos versiones piden la misma cantidad de ether al mismo destino, el riesgo es el mismo aunque la redacción haya cambiado. Si una versión pide una cantidad distinta o un destino distinto, eso es un cambio material aunque la página parezca idéntica.
Compara las cifras, no los párrafos. Es el error más común al comparar documentación: leer dos textos parecidos y concluir que no cambió nada.
Comprueba que ambas versiones dicen lo mismo
A veces la diferencia es de traducción o de terminología, no de contenido. Dos documentos en idiomas distintos describen el mismo flujo con palabras distintas. Antes de tratarlos como versiones diferentes, confirma que describen la misma versión del producto.
La terminología inconsistente dentro de un mismo idioma es una señal de alarma distinta. Suele indicar que el documento mezcla información de momentos diferentes.
Registra la diferencia con su fecha
Anota cada cambio con la fecha en que lo detectaste y la fecha del documento. Sin ese par de fechas no podrás distinguir más adelante entre un cambio real y un documento que simplemente se actualizó por formato.
Un orden de revisión corto
Fecha primero. Después clasifica cada diferencia. Compara las cifras y los destinos. Verifica que ambas versiones se refieran al mismo producto. Registra con fecha.
Una comparación de documentación que no produce una lista de cambios con fecha no terminó: solo leyó dos textos.