{"meta":{"title":"Notas de lanzamiento generadas automáticamente","intro":"Puede generar automáticamente notas de lanzamiento para los lanzamientos de GitHub.","product":"Repositorios","breadcrumbs":[{"href":"/es/repositories","title":"Repositorios"},{"href":"/es/repositories/releasing-projects-on-github","title":"Liberar proyectos"},{"href":"/es/repositories/releasing-projects-on-github/automatically-generated-release-notes","title":"Notas de la versión automatizadas"}],"documentType":"article"},"body":"# Notas de lanzamiento generadas automáticamente\n\nPuede generar automáticamente notas de lanzamiento para los lanzamientos de GitHub.\n\n## Acerca de las notas de lanzamiento generadas automáticamente\n\nLas notas de lanzamiento generadas automáticamente ofrecen una alternativa automatizada a escribir manualmente notas de lanzamiento para tus versiones de GitHub. Con las notas de lanzamiento generadas automáticamente, puedes generar rápidamente un resumen del contenido de un lanzamiento. Las notas de la versión generadas automáticamente incluyen una lista de solicitudes de incorporación de cambios combinadas, una lista de colaboradores para la versión y un vínculo a un registro de cambios completo.\n\nTambié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.\n\n## Crear notas de lanzamiento generadas automáticamente para un lanzamiento nuevo\n\n1. En GitHub, navegue hasta la página principal del repositorio.\n2. A la derecha de la lista de archivos, haga clic en **Releases**.\n\n \n3. En la parte superior de la página, haz clic en **Borrador de una versión nueva**.\n4. Para elegir una etiqueta para la versión, selecciona el menú desplegable **Elegir una etiqueta**.\n * Para usar una etiqueta existente, haz clic en ella.\n * Para crear una etiqueta, escribe un número para la versión y, luego, haz clic en **Crear etiqueta**.\n5. Si creaste una etiqueta, selecciona el menú desplegable **Destino** y, luego, haz clic en la rama que contiene el proyecto que quieres lanzar.\n6. Si quieres, encima del campo de descripción, selecciona el menú desplegable **Etiqueta anterior** y haz clic en la etiqueta que identifica la versión anterior.\n\n \n7. En el campo \"Título de versión\", escribe un título para la versión.\n8. Encima del campo descripción, haga clic en **Generar notas de la versión**.\n9. Verifica las notas generadas para garantizar que incluyan toda (y únicamente) la información que quieras incluir.\n10. 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.\n11. De manera opcional, para notificar a los usuarios de que la versión no está lista para producción y puede ser inestable, selecciona **Esta es una versión preliminar**.\n12. Si lo deseas, selecciona **Establecer como la versión más reciente**. Si no seleccionas esta opción, la etiqueta de versión más reciente se asignará automáticamente en función del Versionamiento Semántico.\n13. De manera opcional, si se habilitó GitHub Discussions para el repositorio, crea un debate para la versión.\n * Selecciona **Crear un debate para esta versión**.\n * Selecciona el menú desplegable **Categoría** y haz clic en una categoría para la discusión de la versión.\n14. Si está listo para publicar la versión, haga clic en **Publish release** (Publicar versión). Para trabajar en el lanzamiento más tarde, haga clic en **Guardar borrador**. Si ha habilitado lanzamientos inmutables para el repositorio, primero crear un borrador le permite adjuntar todos los activos antes de que el lanzamiento se vuelva inmutable.\n Después, puedes ver las versiones publicadas o los borradores en la fuente de versiones del repositorio. Para más información, consulta [Visualizar los lanzamientos y etiquetas de tu repositorio](/es/repositories/releasing-projects-on-github/viewing-your-repositorys-releases-and-tags).\n\n## Configurar las notas de lanzamiento generadas automáticamente\n\n1. En GitHub, navegue hasta la página principal del repositorio.\n2. Encima de la lista de archivos, selecciona el menú desplegable **Add file** y después haz clic en ** Create new file**.\n\n Como alternativa, puedes hacer clic en en la vista de árbol de archivos a la izquierda.\n\n \n3. En el campo del nombre de archivo, escriba `.github/release.yml`. Se creará un archivo denominado `release.yml` en el directorio `.github`.\n4. 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 enumerar las etiquetas del pull request que se deben incluir en cada una de ellas.\n\n### Opciones de configuración\n\n| Parámetro | Descripción |\n| :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------------------------------------------------------------- |\n| `changelog.exclude.labels` | Una lista de etiquetas que excluyen una solicitud de cambios para que no aparezca en las notas de lanzamiento. |\n| `changelog.exclude.authors` | Una lista de manejos de inicio de sesión de usuarios o bots cuyas solicitudes de cambio deben excluirse de las notas de lanzamiento. |\n| `changelog.categories[*].title` | |\n| **Obligatorio.** El título de una categoría de cambios en las notas de la versión. | |\n| `changelog.categories[*].labels` | |\n| **Obligatorio.** Etiquetas que califican una pull request para esta categoría. Use `*` como comodín para las solicitudes de incorporación de cambios que no encajen en ninguna de las categorías anteriores. | |\n| `changelog.categories[*].exclude.labels` | Una lista de etiquetas que excluye una solicitud de cambio para que no aparezca en esta categoría. |\n| `changelog.categories[*].exclude.authors` | Una lista de manejos de inicio de sesión de usuarios o bots cuyas solicitudes de cambio deben excluirse de esta categoría. |\n\n### Configuraciones de ejemplo\n\nConfiguración de un repositorio que etiqueta las versiones de semver\n\n```yaml copy\n# .github/release.yml\n\nchangelog:\n exclude:\n labels:\n - ignore-for-release\n authors:\n - octocat\n categories:\n - title: Breaking Changes 🛠\n labels:\n - Semver-Major\n - breaking-change\n - title: Exciting New Features 🎉\n labels:\n - Semver-Minor\n - enhancement\n - title: Other Changes\n labels:\n - \"*\"\n```\n\nConfiguración de un repositorio que no etiqueta las solicitudes de incorporación de cambios, pero donde queremos separar solicitudes de incorporación de cambios automatizadas de Dependabot en las notas la versión (`labels: '*'` es necesario para mostrar una categoría catchall)\n\n```yaml copy\n# .github/release.yml\n\nchangelog:\n categories:\n - title: 🏕 Features\n labels:\n - '*'\n exclude:\n labels:\n - dependencies\n - title: 👒 Dependencies\n labels:\n - dependencies\n```\n\n## Información adicional\n\n* [Administrar las etiquetas](/es/issues/using-labels-and-milestones-to-track-work/managing-labels)"}