Esta versión de GitHub Enterprise se discontinuó el 2021-09-23. No se realizarán lanzamientos de patch, ni siquiera para problemas de seguridad críticos. Para obtener un mejor desempeño, más seguridad y nuevas características, actualiza a la última versión de GitHub Enterprise. Para obtener ayuda con la actualización, contacta al soporte de GitHub Enterprise.

Configurar pautas para los colaboradores de repositorios

Puedes crear pautas para comunicar cómo pueden contribuir las personas a tu proyecto.

Acerca de los lineamientos de contribución

Para ayudar a los colaboradores de tu proyecto a realizar un buen trabajo, puedes agregar un archivo con las pautas de colaboración a la raíz del repositorio de tu proyecto, carpeta docs, o .github. Cuando alguien abre una solicitud de extracción o crea una propuesta, verán un enlace a ese archivo. El enlace a los lineamientos de contribución también aparece en la página de contribute de tu repositorio. Para encontrar un ejemplo de página de contribute, consulta github/docs/contribute.

contributing-guidelines

Para el propietario del repositorio, las pautas de contribución son una manera de comunicar cómo deben contribuir las personas.

Para los colaboradores, las pautas los ayudan a verificar que están presentando solicitudes de extracción conformadas correctamente y abriendo propuestas útiles.

Tanto para los propietarios como para los colaboradores, las pautas de contribución ahorran tiempo y evitan inconvenientes generados por solicitudes de extracción o propuestas creadas de manera incorrecta que deben ser rechazadas o se deben volver a presentar.

Puedes crear lineamientos de contribución predeterminados para tu organización o cuenta de usuario. Para obtener más información, consulta "Crear un archivo de salud predeterminado para la comunidad."

Sugerencia: los mantenedores de repositorios pueden establecer pautas específicas para las propuestas al crear una plantilla de propuesta o de solicitud de extracción para el repositorio. Para obtener más información, consulta "Acerca de las plantillas de propuestas y solicitudes de extracción".

Agregar un archivo CONTRIBUTING

  1. En GitHub Enterprise Server, visita la página principal del repositorio.
  2. En la parte superior de la lista de archivos, utilizando el menú desplegable de Agregar archivo, da clic en Crear archivo nuevo. "Crear archivo nuevo" en el menú desplegable de "Agregar archivo"
  3. Decide si almacenar tus pautas de contribución en la raíz de tu repositorio, el directorio docs, o el directorio .github. Después, en el campo nombre de archivo, escribe el nombre y la extensión del archivo. Los nombres de archivo de los lineamientos de contribución no distinguen entre mayúsculas y minúsculas. Los archivos se interpretan en formato de texto rico si la extensión de archivo se encuentra en un formato compatible. Para obtener más información, consulta la sección "Trabajar con archivos que no sean de código". Nombre del nuevo archivo
    • Para hacer visibles tus pautas de contribución en el directorio raíz del repositorio, escribe CONTRIBUTING.
    • Para hacer visibles tus pautas de contribución en el directorio docs del repositorio, escribe docs/ para crear el nuevo directorio, y luego CONTRIBUTING.
    • Si un repositorio contiene más de un archivo de CONTRIBUCIÓN, entonces el archivo que se muestra en los enlaces se elige de las ubicaciones en el siguiente orden: el directorio .github, luego el directorio raíz del repositorio y finalmente el directorio docs.
  4. En el nuevo archivo, agrega las pautas de contribución. Pueden incluir:
    • Pasos para crear buenas propuestas o solicitudes de extracción.
    • Enlaces a la documentación externa, listas de correos o un código de conducta.
    • Expectativas de comportamiento y de la comunidad.
  5. En la parte inferior de la página, teclea un mensaje de confirmación corto y significativo que describa el cambio que realizaste al archivo. Puedes atribuir el cambio a mas de un autor en el mensaje del mismo. Para obtener más información, consulta "Crear una confirmación con co-autores múltiples". Mensaje de confirmación de tu cambio
  6. Debajo de los campos del mensaje de confirmación, decide si deseas agregar tu confirmación a la rama actual o a una rama nueva. Si tu rama actual es la rama predeterminada, debes elegir crear una nueva rama para tu confirmación y después crear una solicitud de extracción. Para obtener más información, consulta "Crear una solicitud de extracción nueva". Confirmar opciones de rama
  7. Da clic en Proponer nuevo archivo. Botón para proponer nuevo archivo

Ejemplos de pautas de contribución

Si estás confundido, aquí hay algunos buenos ejemplos de pautas de contribución:

  • Pautas de contribución del Editor Atom .
  • Pautas de contribución de Ruby on Rails .
  • Pautas de contribución de Open Government .

Leer más