Notas de lanzamiento generadas automáticamente

Acerca de las notas de lanzamiento generadas automáticamente

Las notas de lanzamiento generadas automáticamente proporcionan una alternativa de automatización para escribir notas de lanzamiento manualmente para tus lanzamientos de GitHub. Con las notas de lanzamiento generadas automáticamente, puedes generar rápidamente un resumen del contenido de un lanzamiento. Las notas de lanzamiento generadas automáticamente incluyen una lista de solicitudes de cambio fusionadas, una lista de contribuyentes al lanzamiento y un enlace a una bitácora de cambios completa.

También puedes personalizar tus notas de lanzamiento automatizadas, utilizando etiquetas para crear categorías personalizadas para organizar las solicitudes de cambio que quieras incluir y excluyendo ciertas etiquetas y usuarios para que no aparezcan en la salida.

Crear notas de lanzamiento generadas automáticamente para un lanzamiento nuevo

1. En tu instancia de GitHub Enterprise Server, visita la página principal del repositorio.

2. A la derecha de la lista de archivos, haz clic en Lanzamientos.

3. Haz clic en Borrador de un nuevo lanzamiento.

4. Teclea un número de versión para tu lanzamiento. Como alternativa, selecciona una etiqueta existente.

   

5. Si creaste una etiqueta nueva, utiliza el menú desplegable para seleccionar la rama que contiene el proyecto que quieres lanzar.

6. En la esquina derecha de la caja de texto de descripción, haz clic en Auto generar notas de lanzamiento.

7. Verifica las notas generadas para garantizar que incluyan toda (y únicamente) la información que quieras incluir.

8. Opcionalmente, para incluir los archivos binarios tales como programas compilados en tu lanzamiento, arrastra y suelta o selecciona manualmente los archivos en la caja de binarios.

9. Para notificar a los usuarios que el lanzamiento no está listo para producción y puede ser inestable, selecciona Esto es un pre-lanzamiento.

10. Si estás listo para publicitar tu lanzamiento, haz clic en Publicar lanzamiento. Para seguir trabajando luego en el lanzamiento, haz clic en Guardar borrador.

Configurar las notas de lanzamiento generadas automáticamente

1. En tu instancia de GitHub Enterprise Server, visita la página principal del repositorio.
2. En la parte superior de la lista de archivos, utilizando el menú desplegable de Agregar archivo, da clic en Crear archivo nuevo.
3. En el campo de nombre de archivo, teclea .github/release.yml para crear el archivo release.yml en el directorio .github.
4. En el archivo, el utilizar las opciones de configuración siguientes, especificarán en YAML las etiquetas de solicitudes de cambio y los autores que quieras excluir de este lanzamiento. También puedes crear categorías nuevas y listar las etiquetas de la solicitud de cambios que se deben incluir en cada una de ellas.

Opciones de configuración

Ejemplo de configuración

# .github/release.yml

changelog:
  exclude:
    labels:
      - ignore-for-release
    authors:
      - octocat
  categories:
    - title: Breaking Changes 🛠
      labels:
        - Semver-Major
        - breaking-change
    - title: Exciting New Features 🎉
      labels:
        - Semver-Minor
        - enhancement
    - title: Other Changes
      labels:
        - "*"

Leer más

• "Administrar etiquetas"