Release Notes
En una frase
Release Notes se planeó como una aplicación que convierte los cambios entre dos puntos de un repositorio en notas de versión para usuarios finales; en el código está retirada y no disponible como aplicación alojada.
Qué la hace única
Hoy no hay nada activo con lo que compararla, así que este capítulo es una nota de estado y no una guía práctica. La idea era un redactor de notas para usuarios finales: funcionalidades, correcciones de errores y rendimiento, sin nombres de clases ni rutas de archivos.
Cuándo usarla y cuándo no
- No la busques en las páginas alojadas: su página, su controlador, su proceso de trabajo y su tarea se eliminaron del código en la última limpieza, y su hueco en la lista de plugins está marcado como «Retired».
- Usa estas en su lugar:
- Documentos del repositorio (Repo Docs) para la documentación generada a partir de un repositorio.
- Code Graph para un mapa estructural del código en un commit (el nombre del archivo lleva el commit, así que puedes comparar tú mismo las ejecuciones sobre dos commits).
- Chat de Assembly (Assembly Chat), comando Diff, para saber «qué cambió en la API pública de este paquete entre la versión A y la B», con un informe y diagramas.
Antes de empezar
No hay nada que preparar. Si viste una página de Release Notes en una captura de pantalla o en un enlace antiguo, era una interfaz para elegir repositorio, rama e intervalo (desde la última versión, entre dos etiquetas o commits, o cambios sin publicar) y para elegir el público; ya no está en el árbol del producto (comprueba en la aplicación en funcionamiento si sigue en línea alguna página así).
Paso a paso
- No cuentes con una página de Release Notes alojada.
- Para los cambios de API de un paquete .NET, usa Chat de Assembly (Assembly Chat) con el comando Diff.
- Para la documentación del estado actual de un repositorio, usa Documentos del repositorio (Repo Docs).
Opciones explicadas
| Opción | Qué hace | Valor por defecto | Recomendado |
|---|---|---|---|
| (ninguna) | La aplicación está retirada | – | Consulta las alternativas de arriba |
Qué obtienes
Nada de esta aplicación. Existe una herramienta interna relacionada en el planificador de la empresa para generar notas de versión a partir de un análisis de impacto, pero no se expone como página para los lectores de este libro (compruébalo antes de prometérsela a nadie).
Calidad y límites
No procede. Cualquier texto que veas en el sitio y que afirme que Release Notes es compatible debe considerarse desactualizado hasta que se verifique.
Funciona bien con
- Úsalas en su lugar: Chat de Assembly (Assembly Chat) (Diff), Documentos del repositorio (Repo Docs).
- Recetas: ninguna.
Errores frecuentes y soluciones
- Buscar un botón de Release Notes en la página de inicio de IA → no se ofrece.
- Esperar notas para usuarios finales de Repo Docs → Repo Docs escribe documentación técnica, no notas de versión.
Lo mismo en otros canales
No verificado. Consulta canales.
Pruébalo
Compara dos versiones de un paquete NuGet que uses con Chat de Assembly (Assembly Chat) (Diff) y reescribe su informe como tres viñetas en lenguaje llano para tus usuarios. Es lo más parecido que hay hoy como equivalente alojado.