Acerca de las plantillas de propuestas y solicitudes de extracción

Con las plantillas de propuestas y solicitudes de extracción, puedes personalizar y estandarizar la información que quisieras que los colaboradores incluyan cuando abren propuestas y solicitudes de extracción en tu repositorio.

Una vez que creas las plantillas de propuestas y solicitudes de extracción en tu repositorio, los colaboradores pueden usar las plantillas para abrir propuestas o describir los cambios propuestos en sus solicitudes de extracción de acuerdo con las pautas de contribución del repositorio. Para obtener más información sobre cómo agregar pautas de contribución a un repositorio, consulta "Configurar pautas para los colaboradores de repositorios".

Puedes crear plantillas predeterminadas de propuestas y solicitudes de cambios para tu cuenta de organización o de usuario. Para obtener más información, consulta "Crear un archivo de salud predeterminado para la comunidad."

Plantillas de propuestas

Cuando creas plantillas de propuestas para tu repositorio utilizando el creador de plantillas para propuestas, los contribuyentes pueden seleccionar la plantilla adecuada cuando abren propuestas nuevas en el repositorio.

Página de la propuesta nueva que muestra las opciones de plantilla de propuesta

El emitir plantillas es útil cuando quieres proporcionar lineamientos para las propuestas que se abren mientras que permites que los contribuyentes especifiquen el contenido de sus propuestas.

Al usar el creador de plantillas, puedes especificar un título y una descripción para cada plantilla, agregar el contenido de la plantilla y asignar la plantilla a la rama por defecto o bien abrir una solicitud de extracción en el repositorio. El creador de plantillas automáticamente agrega el markup del texto preliminar de YAML que se requiere para que la plantilla aparezca en la página de la propuesta nueva. Para obtener más información, consulta "Configurar plantillas de reporte de problemas para tu repositorio".

Puedes personalizar el selector de plantilla de informe de problemas que ven las personas cuando crean un nuevo informe de problemas en tu repositorio si añades un archivo config.yml a la carpeta .github/ISSUE_TEMPLATE. Para obtener más información, consulta "Configurar plantillas de propuestas para tu repositorio".

Las plantillas de propuestas se almacenan en la rama por defecto del repositorio, en un directorio oculto .github/ISSUE_TEMPLATE. Si creas una plantilla en otra rama, no estará disponible para que la usen los colaboradores. Los nombres de archivo de las plantillas de propuestas no distinguen entre mayúsculas y minúsculas y necesitan tener una extensión .md.Para que se incluyan en el listado de perfiles de la comunidad, las plantillas de informe de problemas deben ubicarse en la carpeta .github/ISSUE_TEMPLATE y contener campos de name: y about: de YAML front matter válidos.

Es posible crear de forma manual una única plantilla de propuesta en Markdown usando el flujo de trabajo de la plantilla de propuesta heredado. Los colaboradores del proyecto automáticamente ven el contenido de la plantilla en el cuerpo de la propuesta. Sin embargo, te recomendamos utilizar el creador de plantillas de propuestas múltiples mejorado para crear plantillas de propuestas. Para obtener más información acerca del flujo de trabajo heredado, consulta "Crear de forma manual una plantilla de propuesta para tu repositorio".

Puedes crear una política de seguridad para dar instrucciones a las personas para reportar las vulnerabilidades de seguridad en tu proyecto. Para obtener más información, consulta "Aumentar la seguridad para tu repositorio".

Plantillas de solicitudes de extracción

Cuando agregas una plantilla de solicitud de extracción a tu repositorio, los colaboradores del proyecto verán automáticamente los contenidos de la plantilla en el cuerpo de la solicitud de extracción.

Plantilla de solicitud de extracción de ejemplo

Debes crear las plantillas en la rama por defecto del repositorio. Las plantillas creadas en otras ramas no están disponibles para que las usen los colaboradores. Puedes almacenar tu plantilla de solicitud de extracción en el directorio raíz visible del repositorio, la carpeta docs o el directorio oculto .github. Los nombres de archivo de la plantilla de solicitud de extracción no distinguen entre mayúsculas y minúsculas y pueden tener una extensión como .md o .txt.

Para obtener más información, consulta Crear plantillas de solicitud de extracción para tu repositorio".

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.