Skip to main content

Creación de un archivo predeterminado de mantenimiento de la comunidad

Puedes crear archivos predeterminados para la salud de la comunidad, como CONTRIBUTING (Contribuciones) y CODE_OF_CONDUCT (Código de conducta). Los archivos predeterminados se utilizarán para cualquier repositorio que pertenezca a la cuenta que no contiene su propio archivo de este tipo.

Acerca de los archivos predeterminados del estado de la comunidad

Los archivos predeterminados de mantenimiento de la comunidad constituyen un conjunto de archivos predefinidos que proporcionan instrucciones y plantillas para mantener un proyecto de código abierto correcto y colaborativo. Puede agregar archivos de mantenimiento de la comunidad predeterminados a un repositorio público denominado .github, en la raíz del repositorio o en las carpetas docs o .github. Estos archivos te permiten automatizar y estandarizar varios aspectos del desarrollo y la interacción con la comunidad de tu proyecto. Son esenciales para fomentar la transparencia, las buenas prácticas y la colaboración en proyectos de código abierto.

GitHub utilizará y mostrará los archivos predeterminados para cualquier repositorio que pertenezca a la cuenta que no tenga su propio archivo de ese tipo en cualquiera de los siguientes lugares:

  • La raíz del repositorio
  • La carpeta .github
  • La carpeta docs

Por ejemplo, cualquiera que crea una propuesta o solicitud de cambios en un repositorio que no tenga su propio archivo de "CONTRIBUTING" verá un enlace en el archivo "CONTRIBUTING" predeterminado. Si un repositorio tiene archivos en una carpeta .github/ISSUE_TEMPLATE propia, incluidas las plantillas de incidencia o un archivo config.yml, no se usará el contenido de la carpeta .github/ISSUE_TEMPLATE predeterminada.

Los archivos predeterminados no aparecerán en el explorador de archivos y no no están incluidos en los clones, paquetes ni descargas de repositorios individuales porque solo se almacenan en el repositorio .github.

Como mantenedor de un repositorio, puede utilizar la lista de comprobación de las normas comunitarias para ver si su proyecto cumple las normas comunitarias recomendadas para ayudar a la gente a utilizar y contribuir a su proyecto. Para obtener más información, vea «Acerca de los perfiles de comunidad para los repositorios públicos».

Tipos de archivo admitidos

Puedes crear valores predeterminados en tu cuenta de la organización o personal para los siguientes archivos de estado de la comunidad:

Archivo de estado de la comunidad | Descripción --- | --- CODE_OF_CONDUCT.md | Un archivo CODE_OF_CONDUCT define los estándares de participación en una comunidad. Para más información, consulta "Agregar un código de conducta a tu proyecto". CONTRIBUTING.md | Un archivo CONTRIBUTING comunica cómo deben contribuir al proyecto los usuarios. Para más información, consulta Configurar pautas para los colaboradores de repositorios. Formularios de categoría de debate | Los formularios de categoría de debate personalizan las plantillas que pueden usar los miembros de la comunidad cuando abren un nuevo debate en el repositorio. Para más información, consulta Creación de formularios de categoría de discusión. FUNDING.yml | Un archivo FUNDING muestra un botón de patrocinador en el repositorio para aumentar la visibilidad de las opciones de financiación del proyecto de código abierto. Para más información, consulta "Botón para mostrar un patrocinador en tu repositorio". GOVERNANCE.md | Un archivo GOVERNANCE permite que los usuarios sepan cómo se rige el proyecto. Por ejemplo, podría analizar los roles del proyecto y cómo se toman las decisiones. Plantillas de incidencias y solicitudes de cambios y config.yml | Las plantillas de incidencias y solicitudes de cambios personalizan y estandarizan la información que te gustaría que incluyeran los colaboradores cuando abran incidencias y solicitudes de cambios en el repositorio. Para obtener más información, vea «Acerca de las plantillas de propuestas y solicitudes de extracción». SECURITY.md | Un archivo SECURITY proporciona instrucciones para informar de una vulnerabilidad de seguridad en el proyecto. Para obtener más información, vea «Agregar una política de seguridad a tu repositorio». SUPPORT.md | Un archivo SUPPORT permite a los usuarios conocer las formas de obtener ayuda con el proyecto. Para obtener más información, vea «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

  1. En la esquina superior derecha de cualquier página, selecciona y luego haz clic en Nuevo repositorio.

    Captura de pantalla del menú desplegable GitHub que muestra las opciones para crear nuevos elementos. El elemento de menú "New repository" está resaltado en naranja oscuro.

  2. Usa el menú desplegable Propietario y selecciona la cuenta de la organización o personal para la que quieras crear archivos predeterminados. Captura de pantalla del menú del propietario de un repositorio de GitHub nuevo. El menú muestra dos opciones, octocat y github.

  3. En el campo "Nombre del repositorio", escribe .github.

  4. Opcionalmente, en el campo "Descripción", teclea una descripción.

  5. Asegúrate de que el estado del repositorio esté establecido en Público. Un repositorio de archivos predeterminados no puede ser privado.

  6. Seleccione Initialize this repository with a README (Inicializar este repositorio con un archivo Léame).

  7. Haga clic en Create repository (Crear repositorio).

  8. En el repositorio, crea uno de los archivos admitidos de estado de la comunidad. Las plantillas de incidencia y su archivo de configuración deben estar en una carpeta denominada .github/ISSUE_TEMPLATE. Todos los demás archivos admitidos pueden estar en la raíz del repositorio, la carpeta .github o la carpeta docs. Para obtener más información, vea «Crear nuevos archivos».