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 reporte de problemas y de solicitud de extracción para tu organización . 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 usando el creador de plantillas de propuestas, estarán disponibles para que las usen los colaboradores cuando abran nuevas propuestas en el repositorio.
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".
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 la plantilla de propuesta no distinguen entre mayúsculas y minúsculas y necesitan 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. Si embargo, recomendamos usar el creador de varias plantillas de propuestas actualizado 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".
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".