Acerca de los archivos predeterminados del estado de la comunidad
Puedes añadir archivos de salud predeterminados para la comunidad en la raíz del repositorio público llamada gihub
que sea propiedad de una organización o cuenta de usuario.
GitHub Enterprise utilizará y mostrará los archivos predeterminados para cualquier repositorio público que sea propiedad de la cuenta que no tiene su propio archivo de ese tipo en ninguno de los siguientes lugares:
- la raíz del repositorio
- la carpeta
.github
- la carpeta
docs
Por ejemplo, una persona que cree una propuesta o solicitud de extracción en un repositorio público que no tenga su propio archivo CONTRIBUTING verá un enlace al archivo CONTRIBUTING predeterminado. Si un repositorio tiene cualquier archivo en su propia carpeta de .github/ISSUE_TEMPLATE
, incluyendo las plantillas de reporte de problemas o un archivode config.yml, no se utilizará ninguno de los contenidos de la carpeta .github/ISSUE_TEMPLATE
.
Los archivos predeterminados no están incluidos en los clones, paquetes ni descargas de repositorios individuales porque se almacenan únicamente en el repositorio .github
.
Tipos de archivos admitidos
Puedes crear versiones predeterminadas en tu organización o cuenta de usuario para los siguientes archivos de salud de la comunidad:
Archivo de salud de la comunidad | Descripción |
---|---|
CONTRIBUTING.md | Un archivo CONTRIBUTING comunica cómo pueden contribuir las personas con tu proyecto. Para obtener más información, consulta "Establecer pautas para los colaboradores del repositorio". |
Plantillas de reporte de problemas y solicitudes de extracción y config.yml | Las plantillas de propuestas y solicitudes de extracción personalizan y estandarizan la información que quieres que incluyan los colaboradores cuando abren propuestas y solicitudes de extracción en tu repositorio. Para obtener más información, consulta "Acerca de las plantillas de propuestas y de solicitudes de extracción". |
SUPPORT.md | Un archivo SOPPORT les permite a las personas conocer las formas de obtener ayuda con tu proyecto. Para obtener más información, consulta "Agregar recursos de soporte a tu proyecto." |
No puedes crear un archivo de licencia predeterminado. Los archivos de licencia se deben agregar a repositorios individuales, de manera que el archivo se incluirá cuando el proyecto se clone, se coloque dentro de un paquete o se descargue.
Crear un repositorio para archivos predeterminados
- En la esquina superior derecha de cualquier página, utiliza el menú desplegable y selecciona Repositorio Nuevo.
- Utiliza el menú desplegable en Propietario, y selecciona la organización o cuenta de usuario para la cual quieres crear los archivos predeterminados.
- Escribe .github como nombre para tu repositorio y escribe una descripción opcional.
- Elige hacer que el repositorio sea público.
- Selecciona Inicializar este repositiro con un README.
- Da clic en Crear repositorio.
- En el repositorio, crea uno de los archivos admitidos de estado de la comunidad. Las plantillas de reporte de problemas y su archivo de configuración deben estar en una carpeta llamada
.github/ISSUE_TEMPLATE
. Todos los demás archivos admitidos deben estar en la raíz del repositorio. Para obtener más información, consulta "Crear nuevos archivos."