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 directrices de contribución a un repositorio, vea "Configuración de directrices para colaboradores del repositorio".
Puedes crear plantillas predeterminadas de incidencias y solicitudes de incorporación de cambios para tu cuenta personal o de la organización. Para más información, vea "Creación de un archivo de estado de la comunidad predeterminado".
Plantillas de propuestas
Al crear plantillas de problemas para el repositorio mediante el generador de plantillas de problemas, los colaboradores pueden seleccionar la plantilla adecuada cuando abran nuevos problemas 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 más información, vea "Configuración de plantillas de incidencia para el repositorio".
Puede personalizar el selector de plantillas de incidencia que ven los usuarios al crear una incidencia en el repositorio si agrega un archivo config.yml a la carpeta .github/ISSUE_TEMPLATE. Para obtener más información, consulta "Configuración de plantillas de incidencias para el repositorio".
Las plantillas de problemas se almacenan en la rama predeterminada 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 las incluya en una lista de verificación de perfiles de la comunidad, las plantillas de propuestas se deben ubicar en la carpeta .github/ISSUE_TEMPLATE y deben contener un name: y about: válidos expresados en lenguaje YAML.
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. Pero se recomienda usar el generador de plantillas de varios problemas actualizado para crear plantillas de problemas. Para obtener más información sobre el flujo de trabajo heredado, vea "Creación manual de una sola plantilla de problemas para el repositorio".
Puedes crear una política de seguridad para dar instrucciones a las personas para reportar las vulnerabilidades de seguridad en tu proyecto. Para más información, vea "Adición de una directiva de seguridad al repositorio".
Plantillas de solicitud de incorporación de cambios
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. Puede almacenar su plantilla de solicitud de incorporación de cambios en el directorio raíz visible del repositorio, la carpeta docs o el directorio .github oculto. Los nombres de archivo de la plantilla de solicitud de incorporación de cambios no distinguen entre mayúsculas y minúsculas y pueden tener una extensión como .md o .txt.
Para obtener más información, vea "Creación de una plantilla de solicitud de incorporación de cambios para el repositorio".