Frecuentemente publicamos actualizaciones de nuestra documentación. Es posible que la traducción de esta página esté en curso. Para conocer la información más actual, visita la documentación en inglés. Si existe un problema con las traducciones en esta página, por favor infórmanos.

Crear un archivo predeterminado del estado de la comunidad para tu organización

Puedes crear archivos predeterminados del estado de la comunidad para tu organización, como CONTRIBUTING y CODE_OF_CONDUCT. Los archivos predeterminados se usarán para cualquier repositorio público de tu organización que no contenga su propio archivo de ese tipo.

En esta guía

Acerca de los archivos predeterminados del estado de la comunidad

Puedes agregar archivos predeterminados del estado de la comunidad para tu organización en la raíz del repositorio público llamado .github que es propiedad de la organización.

GitHub usará y mostrará los archivos predeterminados para cualquier repositorio público de la organización que no tenga su propio archivo de este tipo en cualquiera 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. If a repository has any files in its own .github/ISSUE_TEMPLATE folder, including issue templates or a config.yml file, none of the contents of the default .github/ISSUE_TEMPLATE folder will be used.

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 archivos predeterminados en toda la organización para los siguientes archivos del estado de la comunidad:

Archivo de salud de la comunidad Descripción
CODE_OF_CONDUCT.md Un archivo CODE_OF_CONDUCT define las normas para participar en una comunidad. Para obtener más información, consulta "Agregar un código de conducta a tu proyecto".
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".
FUNDING.yml Un archivo FUNDING muestra un botón de patrocinador en tu repositorio para aumentar la visibilidad de las opciones de financiación para tu proyecto de código abierto. Para obtener más información, consulta "Mostrar un botón de patrocinador en tu repositorio".
Issue and pull request templates and 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".
SECURITY.md Un archivo SECURITY da indicaciones para informar responsablemente acerca de una vulnerabilidad de seguridad en tu proyecto. Para obtener más información, consulta "Aumentar la seguridad para tu repositorio".
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 para tu organización. 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

  1. In the upper-right corner of any page, use the drop-down menu, and select New repository.

    Drop-down with option to create a new repository

  2. Usa el menú desplegable Propietario y selecciona la organización para la que deseas crear archivos predeterminados.

    Menú desplegable Propietario

  3. Escribe .github como nombre para tu repositorio y escribe una descripción opcional.

    Crear un campo de repositorio

  4. Elige hacer que el repositorio sea público.

    Botones de selección para seleccionar el estado público o privado

  5. Selecciona Inicializar este repositorio con un README.

    Inicializar este repositorio con una casilla de verificación README

  6. Haz clic en Crear repositorio.

  7. En el repositorio, crea uno de los archivos admitidos de estado de la comunidad. Issue templates and their configuration file must be in a folder called .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."

Pregunta a una persona

¿No puedes encontrar lo que estás buscando?

Contáctanos