Las notas de la versión son un pequeño puente entre una implementación y las personas que utilizan el producto. Traduzca los detalles de la implementación en el cambio que un lector puede notar y distinga una nueva capacidad de una solución o una acción requerida.
Responde las preguntas del lector.
- ¿Qué cambió en el producto o flujo de trabajo?
- ¿Quién puede utilizar el cambio? ¿Está disponible ya en todas partes?
- ¿Necesita el lector actualizar, migrar datos o cambiar una configuración?
Sea precisa sobre la disponibilidad
Utilice un lenguaje sencillo y evite prometer una fecha de lanzamiento o un resultado que no haya sido confirmado. Mencione las limitaciones que afectan la forma en que alguien puede usar la función.
Pídale a un compañero de equipo fuera de la implementación que revise las notas. Si no pueden decir qué cambió o qué hacer a continuación, revise la explicación antes de publicarla.