OK, siempre me he preguntado esto, así que lo preguntaré…
Recibo correos electrónicos de nuestra instancia de Discourse informándome que está disponible una “Nueva versión”.
Tiene un enlace: “Ver qué hay de nuevo en las notas de la versión…”.
Pero cuando hago clic en el enlace, no hay ninguna mención de esa nueva versión ni de sus notas de lanzamiento.
Mira aquí: decía que la nueva versión era la 2.5.2, pero ahora mira la pantalla a la que apunta el enlace. ¿Ves alguna mención a las notas de lanzamiento de la 2.5.2?
Así que, en lugar de ayudarme, el enlace me frustró.
Gracias, pero solo para estar en la misma página…
El enlace indica que me llevará a las notas de la versión 2.5.2, pero no es así. En ningún lugar de ese enlace/página se mencionan las notas de la versión 2.5.2.
Lo mismo ocurrió en el último anuncio.
Normalmente no publicamos notas de lanzamiento para las actualizaciones estables, ya que suelen ser cambios muy menores, solo correcciones de errores esenciales retrocompatibles, etc. Es posible que puedas extraer los cambios estables de GitHub mediante un enlace especial; quizás @jomaxro tenga alguna idea.
Generalmente recomendamos que te mantengas en la rama tests-passed; todos nuestros clientes y servicios de alojamiento están en tests-passed.
Jeff tiene razón, no escribo notas de versión para lanzamientos estables. El correo electrónico que recibiste es un mensaje estándar compartido por todas las instancias de Discourse. No sabe en qué rama te encuentras.
Los lanzamientos puntuales estables solo incluyen correcciones críticas de errores y parches de seguridad. A diferencia de nuestros lanzamientos habituales, que contienen cientos de cambios, los lanzamientos puntuales estables generalmente tienen menos de 10, y en muchas ocasiones mucho menos.
Puedes ver todos los cambios en https://github.com/discourse/discourse/commits/stable. Busca “Incremento de versión a v{versión actual}” y “Incremento de versión a v{versión anterior}”. Todo lo que haya entre ambos es el conjunto de cambios. En el caso de v2.5.2, hay 7 cambios: 3 de seguridad, 2 derivados de los cambios de seguridad y 2 correcciones críticas de rendimiento.
Entendido. Tu razonamiento para no publicar notas de lanzamiento en versiones estables tiene cierto sentido. Mi único punto es que MUCHOS de nosotros recibimos notificaciones por correo electrónico y, en la MAYORÍA de los casos, el enlace a las notas de lanzamiento no dice nada. Una opción sería cambiar la plantilla para establecer mejor las expectativas, en lugar de que me sienta engañado y, por lo general, haga clic solo para descubrir que no hay nada relacionado con el correo electrónico que acabo de recibir.
Si fuera nuestro producto, me tomaría 10 minutos para crear una nota de lanzamiento para cada versión.
Simplemente diciendo: “Esta es una versión menor. Bajo riesgo. Mayormente correcciones de errores. Pero sí cambiamos la forma en que se maneja xxx, por si quieres estar al tanto de esa mejora o del impacto potencial.”
Propongo que se actualice la plantilla de correo electrónico estándar para las actualizaciones:
Cambiar
"Consulta qué hay de nuevo en las notas de la versión"
por
“Revuelve estas notas de la versión e intenta averiguar qué incluye esta nueva versión, ya que no hay notas de lanzamiento para esta versión”
Contexto
Hoy recibí otro correo indicando que la versión 2.7.1 está disponible y que consulte el enlace a las notas de la versión, el cual no contiene ninguna nota para la 2.7.1. El enlace debería ser útil o bien omitirse.
Tuvimos una discusión interna. Como supongo que entenderás, no vamos a cambiar el texto por el que propusiste. Aunque seguimos recomendando que los sitios se mantengan en tests-passed, que es la opción predeterminada, vamos a crear notas de lanzamiento para las versiones estables de ahora en adelante. Ten en cuenta que estas notas no incluirán el mismo nivel de detalle que las notas de lanzamiento normales, ya que las actualizaciones estables solo incluyen correcciones críticas de errores y parches de seguridad.
Muy bien. Me disculpo por mi tono sarcástico, pero cuando recibo el aviso de una nueva versión, mi primera reacción es hacer clic en el enlace para ver cómo podría afectar esta versión a mis usuarios y qué prioridad tiene actualizar, etc. Sin embargo, siempre me siento frustrado porque el enlace no hace eso y, en la mayoría de los casos, nunca hay documentos que hagan referencia al mismo número de versión en la actualización. Ahora debo decidir cuánto tiempo dedicar a buscar documentos específicos de esa versión, etc. Obviamente, un documento que mencione una versión “beta” o un número de versión anterior podría ser significativamente diferente de la versión final, por lo que esos documentos no me son de utilidad.
Para futuras referencias, el registro de cambios efectivo para un aumento mayor de versión estable, como 2.5.0, es la suma de todas las versiones beta que comienzan con la versión: 2.5.0.beta[1,2,3,4,5,6,7]. Nos esforzamos por mantener las versiones “beta” utilizables en todo momento, y nuestra rama “estable” se centra más en la ausencia de cambios que en la ausencia de errores.
Esperamos que las notas de la versión parche ayuden a aclarar la confusión.
