Las notas de la versión de una integración deben explicar los cambios mediante las acciones del usuario
«Adaptador corregido» le dice poco a quien actualiza un cliente que funciona. Para tu integración con SimAggregator, describe el comportamiento visible: qué ocurría antes, qué ocurre ahora y si el usuario debe hacer algo después de actualizar. El nombre interno de una tarea puede quedarse como enlace.
Si cambió la recuperación de la página, explica si las tareas locales existentes siguen siendo accesibles y qué limitaciones se mantienen. No presentes una mejora de tu propia interfaz como un cambio en las reglas de la plataforma externa. Indica el alcance: versión del cliente, pantalla afectada y ajuste necesario.
Destaca los puntos que requieren atención, como un nuevo formato de archivo local, una comprobación de la configuración o un límite de compatibilidad. Pide a un colega que aún use la versión anterior que siga las instrucciones. Debería entender la ruta de actualización sin una explicación privada del autor.
Publica las notas traducidas junto con el texto principal, sobre todo cuando las acciones de pago se comportan de otra manera. No dejes en uno de los idiomas una antigua recomendación de reintentar. Unas notas de la versión útiles pueden ser breves y aun así responder qué cambia en el trabajo de la persona y cómo puede verificar que la actualización salió bien.