Cómo comparar la documentación de una dapp con su interfaz
Una rutina para revisar etiquetas, permisos y pasos de transacción con fuentes oficiales.
Este artículo puede contener enlaces de afiliados. Las relaciones comerciales se detallan en la política de afiliados.
La documentación de una aplicación y la interfaz que estás usando deberían contar lo mismo. Casi nunca lo hacen de forma idéntica, y esa diferencia genera errores: ejecutas un paso que el documento explica de una manera y la aplicación te pide otra cosa.
Comparar ambos textos es un paso corto. Es lo que evita firmar una transacción con una autorización que no entendías, porque el documento omitía el paso que la interfaz sí exige.
Dos textos parecidos que no son iguales
La documentación se escribe para durar meses. La interfaz se actualiza con frecuencia. De ahí nacen las diferencias.
El documento suele describir el flujo ideal, con capturas de pantalla que tienen meses. La interfaz muestra el flujo actual, con campos reordenados, etiquetas traducidas y un paso de confirmación que nadie documentó cuando se añadió.
Ninguna de las dos versiones está necesariamente mal. Lo peligroso es seguir una esperando que la otra lo describa.
Dónde empezar la comparación
Abre la documentación y la interfaz a la vez. Sitúa el mismo punto inicial en las dos: la pantalla de conexión, el formulario de envío o la confirmación de la operación.
El objetivo es localizar divergencias, no leer los dos textos completos. Busca los momentos donde la interfaz pide una acción: botones que se pulsan, campos que se rellenan, confirmaciones que se aceptan.
Cada uno de esos momentos es un punto de cotejo.
La pregunta que revela las diferencias
Para cada paso de la documentación, haz esta pregunta: ¿qué tendría que hacer yo aquí?
Si la respuesta es un botón que en la interfaz no existe, o una casilla que aparece y no está documentada, ya tienes una divergencia. Anótala y sigue.
Escribe la respuesta antes de comprobar el resultado. Escribirlo después convierte la descripción en una justificación, y deja de servir como control.
Las divergencias que importan
No todas las diferencias valen lo mismo. Estas son las que cambian el resultado:
- Autorizaciones. Si la interfaz pide una aprobación que la documentación no menciona, es un hallazgo serio. Revisa qué contrato recibe ese permiso y qué puede mover después.
- Red. Un mismo nombre de activo puede existir en varias redes. Si la documentación asume una red y la interfaz está en otra, los pasos ya no describen lo mismo.
- Campos obligatorios. Los campos que aparecen sin explicación suelen ser los que alguien rellena sin entender.
- Confirmaciones. Una pantalla de confirmación nueva es el punto donde se ejecuta una acción irreversible.
El resto de las diferencias, como un texto reformulado o un botón reordenado, son cosméticas.
El orden de los pasos también es información
A veces el contenido no cambia, pero el orden sí. Si la documentación pide conectar la cartera después de elegir el importe y la interfaz lo pide antes, una de las dos se ha quedado atrás.
El orden importa porque las carteras suelen perder el estado cuando la página se recarga o cuando cambia de sección. Un paso que en el documento iba al final puede quedar invalidado por uno que en la interfaz va al principio.
Una tabla de cotejo que funciona
Anota cada paso en dos columnas: lo que dice el documento y lo que encuentras en la interfaz.
Para cada fila añade una tercera columna con el resultado: coinciden, difieren o falta. En la columna de las diferencias escribe siempre qué hiciste, no qué esperabas.
Una tabla de este tipo tarda pocos minutos y detecta la mayoría de los fallos antes de enviar nada. La clave es hacerla antes de la operación.
Cuando la documentación está desactualizada
Las señales más frecuentes de un texto que ya no sigue al producto son conocidas:
- Las capturas muestran una interfaz que ha cambiado.
- El documento cita una función que se ha renombrado o retirado.
- Las cifras de costes vienen sin fecha de vigencia.
- No aparece ninguna fecha de actualización en toda la página.
- El texto habla de una versión anterior del producto.
Ante cualquiera de estas señales, el documento puede seguir siendo útil como explicación conceptual, pero no como guía de pasos.
Tu propio registro después de la operación
Una vez terminas, anota qué pasos se cumplieron y cuáles no. Ese registro es más útil que el propio documento para la próxima revisión.
Incluye la fecha, la versión de la interfaz y cualquier divergencia que encontraste. En una segunda lectura del mismo flujo, tu registro te dirá en diez segundos si el problema sigue ahí.
Lo que este cotejo no resuelve
Comparar documento e interfaz no indica si el contrato es legítimo, ni si la aplicación fue auditada, ni si tu cartera está bien configurada. Son preguntas distintas, con fuentes distintas.
Lo que sí resuelve, y con poco esfuerzo, es la pregunta práctica: ¿los pasos que estás a punto de seguir describen lo que tienes delante? Cuando la respuesta es que no, ya sabes dónde detenerte.