Cómo revisar una guía cripto después de un cambio de interfaz
Una rutina para comparar etiquetas, permisos, red y fuente oficial cuando una pantalla cambia.
Este artículo puede contener enlaces de afiliados. Las relaciones comerciales se detallan en la política de afiliados.
Las interfaces de las billeteras y de los protocolos cambian con frecuencia: se renombran botones, se reorganizan los menús, aparece una pantalla de confirmación nueva o una etiqueta que antes no estaba. Una guía escrita hace seis meses puede seguir siendo correcta en su explicación y estar equivocada en la práctica, porque el lector ya no encuentra lo que el texto le indica.
Qué cambia realmente cuando se modifica una interfaz
No todos los cambios tienen el mismo peso. Vale la pena distinguirlos antes de decidir si hace falta reescribir la guía o basta con añadir una nota.
- Cambios de ubicación: el mismo botón en otro menú. La instrucción sigue siendo válida, pero el lector se pierde si el texto dice que debe pulsar el botón de la esquina superior derecha.
- Cambios de nombre: una operación pasa a llamarse “Intercambiar” en lugar de “Swap”, o se sustituye una palabra por un icono. El texto antiguo obliga a traducir mentalmente, y ahí es donde aparecen los errores.
- Cambios en la confirmación: aparece un paso nuevo o se invierte el orden de los pasos. Aquí una guía sin capturas puede inducir a confirmar una operación distinta de la prevista.
- Cambios de permisos: una pantalla que antes solo mostraba el balance ahora pide una aprobación de tokens. Es el cambio más importante, porque modifica lo que firmas y no solo dónde haces clic.
Rutina de revisión en cinco pasos
-
Anota la fecha del cambio. La propia aplicación o el registro de cambios del protocolo suelen proporcionarla. Sin fecha no hay forma de saber si la guía era válida antes o después.
-
Repite el recorrido completo desde la pantalla inicial, no desde el punto medio. Muchas guías asumen que el lector ya está dentro del menú, y ahí se rompe la analogía con la interfaz real.
-
Compara término por término. Escribe en una columna la etiqueta que usa la guía y en otra la que aparece hoy en pantalla. Cualquier diferencia de una palabra puede ser una diferencia de comportamiento.
-
Verifica que la pantalla de confirmación sigue mostrando lo mismo. El identificador del contrato, la red, la cantidad y la dirección de destino deben aparecer antes de la firma. Si algo desapareció, la guía debe decirlo explícitamente.
-
Registra el resultado con la fecha y la versión. Una línea con la aplicación, la versión y la fecha de revisión convierte el texto en algo auditable más adelante.
Cómo tratar la parte que cambió
Si el cambio es de ubicación, actualiza la instrucción y conserva el resto. Si el cambio afecta a lo que se firma, la guía necesita una sección de advertencia, no solo una instrucción nueva. Y si la guía describía una pantalla que ya no existe en ninguna versión, conviene retirarla del índice y dejar un enlace hacia la versión actual, en lugar de mantener dos textos que se contradicen.
Un buen criterio de publicación es este: la guía debe poder leerse siguiendo la interfaz real de hoy, sin que el lector tenga que adivinar a qué botón se refiere el texto. Cuando eso se cumple, la guía sigue siendo útil aunque la interfaz vuelva a cambiar, porque explica el objetivo y no solo la posición de un botón.
Errores frecuentes
- Dar el texto por bueno porque “el sentido se entiende”. Entenderse no es lo mismo que ser accionable: si el lector busca una etiqueta que ya no existe, se queda parado.
- Actualizar la captura y olvidar el texto. La imagen nueva transmite que todo está en orden, incluso cuando el párrafo sigue describiendo la pantalla anterior.
- Copiar el recorrido de otra billetera. Cada interfaz tiene su propia estructura, y un texto que describe el menú de una aplicación no describe el de otra aunque ejecuten la misma acción.
- Tratar toda actualización como urgente. Un cambio de icono no invalida la guía; uno que añade una firma sí.