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 de solicitudes de cambios y propuestas predeterminadas para tu cuenta de organización o personal. 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.
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.
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".