Qué hace vincular un proyecto a un repositorio
Un proyecto de GitHub es un tablero de planificación para issues y pull requests.
Un repositorio guarda tu código.
Son cosas separadas, y una confusión habitual es si deberías conectarlas o no.
Esta guía explica qué hace realmente la vinculación, cuándo ayuda, cuándo no, y cómo hacerlo correctamente.
Cuando añades un proyecto a un repositorio, el proyecto se vuelve accesible desde ese repositorio, normalmente a través de la pestaña Projects del repositorio.
GitHub Docs permite listar proyectos relevantes en un repositorio, así quien navegue el código ve la planificación vinculada GitHub Docs.
Vincular no mueve tus issues, no copia tu tablero ni cambia quién puede editar el proyecto.
Crea una conexión visible para que las personas que trabajan en el repositorio encuentren el proyecto sin buscarlo en otro lugar.
Dos reglas que debes conocer antes de vincular
GitHub aplica dos condiciones, y ambas suelen causar problemas con frecuencia.
La propiedad debe coincidir
Solo puedes listar proyectos que pertenezcan al mismo usuario u organización que es dueño del repositorio GitHub Docs.
Si tu repositorio está bajo una organización pero tu proyecto está bajo tu cuenta personal, el proyecto no aparecerá en la pestaña Projects del repositorio.
Esta es la razón más común por la que la gente concluye que la vinculación no funciona.
No es que esté rota; la propiedad no coincide.
La solución es mover el proyecto bajo el mismo dueño que el repositorio, o aceptar que el enlace no puede hacerse en esa dirección.
La visibilidad controla quién ve el enlace
Incluso después de listar un proyecto en un repositorio, los miembros del repositorio solo lo ven si tienen visibilidad del proyecto en sí .