Colaboradores en GitHub

Los colaboradores en GitHub permiten que varias personas trabajen directamente sobre un mismo repositorio. En este artículo aprenderás qué son, para qué sirven, cómo agregarlos, gestionar sus permisos y organizar el trabajo mediante ramas, commits y Pull Requests.

Índice

1. ¿Qué son los colaboradores en GitHub?

Los colaboradores en GitHub son usuarios que reciben permisos para trabajar directamente sobre un repositorio. Esto permite que varias personas puedan participar en el mismo proyecto, realizar cambios, crear ramas, subir código y colaborar en su desarrollo sin necesidad de compartir una misma cuenta.

Por ejemplo, si tienes un repositorio de una página web y quieres trabajar con otra persona, puedes agregarla como colaboradora para que pueda acceder al proyecto y realizar cambios según los permisos disponibles.

Los colaboradores son especialmente útiles en proyectos desarrollados entre varias personas, trabajos académicos, proyectos personales con ayuda externa y equipos de desarrollo.

2. ¿Cómo agregar un colaborador?

Para agregar una persona como colaboradora, debes tener los permisos necesarios sobre el repositorio.

Paso 1: Entrar al repositorio

Accede a GitHub y abre el repositorio al que quieres agregar al colaborador.

Paso 2: Abrir la configuración

Dentro del repositorio, entra en:

Settings → Collaborators

La ubicación exacta de algunas opciones puede variar según el tipo de repositorio y la interfaz actual de GitHub.

Paso 3: Agregar una persona

Busca la opción para agregar personas o colaboradores y escribe su nombre de usuario de GitHub o su dirección de correo electrónico.

Paso 4: Enviar la invitación

Selecciona al usuario correspondiente y envía la invitación.

La persona deberá aceptar la invitación para comenzar a trabajar con el repositorio.

¿Cómo aceptar una invitación para colaborar?

Cuando alguien te agrega como colaborador, GitHub puede enviar una invitación a tu cuenta.

Para comenzar a colaborar:

Inicia sesión en GitHub.
Abre la invitación recibida.
Revisa el repositorio y la cuenta que te está invitando.
Acepta la invitación.
Accede al repositorio.

Una vez aceptada, tendrás los permisos que el propietario o administrador del repositorio haya establecido.

3. ¿Qué puede hacer un colaborador?

Lo que puede hacer un colaborador depende de los permisos que tenga asignados en el repositorio.

Según el nivel de acceso, puede realizar acciones como:

Ver el código del repositorio.
Crear ramas.
Modificar archivos.
Subir cambios con git push.
Crear Pull Requests.
Revisar cambios.
Crear y gestionar Issues.
Trabajar con diferentes ramas.
Participar en la administración del proyecto.

Por eso, agregar a alguien como colaborador no significa necesariamente darle acceso ilimitado a todas las funciones del repositorio.

3.1. ¿Qué permisos tienen?

GitHub utiliza diferentes niveles de permisos para determinar qué acciones puede realizar cada usuario.

Entre los permisos que puedes encontrar están:

Read:
- permite consultar el contenido del repositorio.
Triage:
- permite gestionar determinados elementos como Issues y Pull Requests sin modificar directamente el código.
Write:
- permite realizar cambios y contribuir al código.
Maintain:
- proporciona permisos adicionales para administrar determinados aspectos del repositorio.
Admin:
- proporciona el nivel más alto de permisos sobre el repositorio.

4. ¿Cómo comprobar quiénes son los colaboradores?

Los usuarios que tienen acceso a un repositorio pueden consultarse desde la configuración del mismo.

Generalmente, debes entrar en:

Repositorio → Settings → Collaborators

Desde allí puedes consultar las personas que tienen acceso y, dependiendo de tus permisos, administrar su acceso.

5. ¿Cómo eliminar un colaborador?

Si ya no quieres que una persona tenga acceso al repositorio, puedes eliminarla como colaborador siempre que tengas permisos suficientes.

El procedimiento general es:

Abre el repositorio.
Entra en Settings.
Accede a la sección de colaboradores.
Busca al usuario.
Selecciona la opción para eliminar o modificar su acceso.
Confirma la operación.

Al retirar el acceso, la persona dejará de tener los permisos que tenía sobre ese repositorio.

6. Diferencia entre colaborador y propietario

El propietario es quien tiene la propiedad del repositorio y puede administrar aspectos fundamentales del mismo.

Un colaborador, en cambio, recibe determinados permisos para trabajar sobre el repositorio.

Por ejemplo:

Característica	Propietario	Colaborador
Ver el repositorio	Sí	Según permisos
Modificar código	Sí	Según permisos
Crear ramas	Sí	Según permisos
Crear Pull Requests	Sí	Según permisos
Administrar colaboradores	Sí	Depende de permisos
Administrar configuración	Sí	Depende de permisos

Por lo tanto, colaborar en un repositorio no significa ser propietario del mismo.

7. Diferencia entre Colaborador o Fork

Son dos formas diferentes de participar en un proyecto.

7.1. Colaborador

El usuario recibe permisos directamente sobre el repositorio original.

Repositorio original
        ↓
   Colaborador
        ↓
   Modifica el proyecto

Es habitual cuando existe una relación directa entre las personas que desarrollan el proyecto.

7.2. Fork

El usuario crea una copia del repositorio en su propia cuenta.

Repositorio original
        ↓
       Fork
        ↓
Copia en otra cuenta
        ↓
   Modificaciones
        ↓
Pull Request

El Fork es especialmente habitual en proyectos de código abierto donde no se concede acceso directo de escritura al repositorio original.

8. Buenas prácticas al trabajar con colaboradores

Cuando varias personas trabajan en un mismo repositorio, es recomendable establecer algunas reglas.

8.1. Utilizar ramas para desarrollar funcionalidades

Evita que todos los colaboradores trabajen directamente sobre main.

8.2. Mantener actualizado el repositorio

Antes de comenzar a trabajar conviene comprobar si existen cambios nuevos:

git pull

8.3. Utilizar mensajes de commit claros

Por ejemplo:

git commit -m "Agrega formulario de contacto"Lenguaje del código: JavaScript (javascript)

En lugar de:

git commit -m "Cambios"Lenguaje del código: JavaScript (javascript)

8.4. Revisar los Pull Requests

Antes de incorporar cambios a la rama principal, es recomendable revisarlos.

8.5. Conceder únicamente los permisos necesarios

No todos los colaboradores necesitan permisos administrativos. Asignar el nivel adecuado ayuda a proteger el proyecto.

9. Ventajas de utilizar colaboradores en GitHub

Trabajar con colaboradores ofrece varias ventajas:

Permite desarrollar proyectos entre varias personas.
Facilita la organización del código.
Permite trabajar mediante ramas.
Facilita la revisión de cambios.
Permite utilizar Pull Requests.
Centraliza el proyecto en un repositorio.
Facilita el trabajo remoto.
Permite controlar quién tiene acceso al código.

10. ¿Cuándo conviene utilizar colaboradores?

Los colaboradores son especialmente útiles cuando:

Trabajas con un compañero en un proyecto.
Desarrollas una aplicación entre varias personas.
Participas en un proyecto de trabajo.
Realizas un proyecto académico.
Necesitas que otra persona pueda modificar directamente un repositorio.
Formas parte de un equipo pequeño de desarrollo.

Si no quieres conceder acceso directo al repositorio original, puede ser más conveniente utilizar un Fork y posteriormente enviar un Pull Request.

11. Ejemplo práctico

Imaginemos que tienes un repositorio llamado:

mi-pagina-web

Tú eres el propietario y quieres que otra persona te ayude a desarrollar el proyecto.

El flujo podría ser:

1. Creas el repositorio
        ↓
2. Agregas al colaborador
        ↓
3. El colaborador acepta la invitación
        ↓
4. Clona el repositorio
        ↓
5. Crea una rama
        ↓
6. Realiza cambios
        ↓
7. Hace commit
        ↓
8. Hace push
        ↓
9. Crea un Pull Request
        ↓
10. Revisas los cambios
        ↓
11. Haces merge

De esta forma, ambos pueden trabajar sobre el mismo proyecto manteniendo un flujo organizado.

12. Conclusión

Los colaboradores en GitHub permiten que varias personas trabajen directamente sobre un mismo repositorio, utilizando permisos, ramas, commits, git push y Pull Requests para organizar el desarrollo. Es una de las herramientas fundamentales para trabajar en equipo y mantener un proyecto controlado mediante Git y GitHub.

Para la estructura de tu curso, este artículo encaja muy bien después de Pull Requests y antes de Issues, aunque conceptualmente también puedes colocarlo inmediatamente después de explicar ramas y Pull Requests. Así el lector ya conoce las herramientas necesarias para entender cómo varias personas pueden trabajar sobre un mismo repositorio.