Si encuentras algún detalle que no comprendes puedes comentarlo y trataremos de ayudarte tan rápido como podamos.
Solución:
Dato 1: Proyectos y Repositorios siempre fueron sinónimos en GitHub.
Hecho 2: Este ya no es el caso.
Hay mucha confusión sobre Repositorios y Proyectos. En el pasado, los usuarios y la propia documentación de GitHub usaban ambos términos de manera bastante intercambiable. Esto se refleja en algunas de las respuestas y comentarios aquí que explican las diferencias sutiles entre esos términos y cuándo se prefirió uno sobre el otro. La diferencia siempre fue sutil, por ejemplo, que el rastreador de problemas sea parte del proyecto pero no del repositorio, lo que podría considerarse estrictamente como algo git, etc.
Ya no.
Actualmente los reportos y proyectos se refieren a un diferentes tipos de entidades eso tiene API separadas:
- https://developer.github.com/v3/repos/
- https://developer.github.com/v3/proyectos/
Desde entonces, ya no es correcto llamar al repositorio un proyecto o viceversa. Tenga en cuenta que a menudo se confunde en la documentación oficial y es lamentable que se haya elegido un término que ya se usaba ampliamente como nombre de la nueva entidad, pero este es el caso y tenemos que vivir con eso.
La consecuencia es que los repositorios y los proyectos generalmente se confunden y cada vez que lees sobre los proyectos de GitHub, debes preguntarte si realmente se trata de los proyectos o de los repositorios. Si hubieran elegido algún otro nombre o una abreviatura como “proj”, entonces podríamos saber que lo que se discute es el nuevo tipo de entidad, un objeto preciso con propiedades concretas, o un tipo de cosita proyectual similar a un repositorio.
El término que suele ser inequívoco es “tablero de proyecto”.
¿Qué podemos aprender de la API?
El primer punto final en la documentación de la API de Proyectos:
- https://developer.github.com/v3/projects/#list-repository-projects
se describe como: Listar proyectos de repositorio. Significa que un repositorio puede tener muchos proyectos. Así que esos dos no pueden significar lo mismo. Incluye Respuesta si los proyectos están deshabilitados:
"message": "Projects are disabled for this repo",
"documentation_url": "https://developer.github.com/v3"
lo que significa que algunos repositorios pueden tener proyectos deshabilitados. Nuevamente, eso no puede ser lo mismo cuando un repositorio puede tener proyectos deshabilitados.
Hay algunos otros puntos finales interesantes:
- Crear un proyecto de repositorio –
POST /repos/:owner/:repo/projects - Crear un proyecto de organización –
POST /orgs/:org/projects
pero hay no:
Crear un proyecto de usuario –POST /users/:user/projects
Lo que nos lleva a otra diferencia:
1. Los repositorios pueden pertenecer a usuarios u organizaciones
2. Los proyectos pueden pertenecer a repositorios u organizaciones
o, más importante:
1. Los proyectos pueden pertenecer a repositorios pero no al revés
2. Los proyectos pueden pertenecer a organizaciones pero no a usuarios
3. Los repositorios pueden pertenecer a organizaciones y a usuarios
Ver también:
- https://help.github.com/articles/about-project-boards/
Sé que es confuso. Traté de explicarlo con la mayor precisión posible.
GitHub introdujo recientemente una nueva característica llamada Proyectos. Esto proporciona un tablero visual que es típico de muchas herramientas de gestión de proyectos:
Un repositorio como se documenta en GitHub:
Un repositorio es el elemento más básico de GitHub. Son más fáciles de imaginar como la carpeta de un proyecto. Un repositorio contiene todos los archivos del proyecto (incluida la documentación) y almacena el historial de revisión de cada archivo. Los repositorios pueden tener múltiples colaboradores y pueden ser públicos o privados.
Un proyecto como se documenta en GitHub:
Los tableros de proyectos en GitHub lo ayudan a organizar y priorizar su trabajo. Puede crear tableros de proyectos para trabajos de características específicas, hojas de ruta integrales o incluso listas de verificación de lanzamiento. Con los tableros de proyectos, tiene la flexibilidad de crear flujos de trabajo personalizados que se adapten a sus necesidades.
Parte de la confusión es que la nueva característica, Proyectos, entra en conflicto con el uso sobrecargado del término proyecto en la documentación anterior.
Los repositorios de GitHub se utilizan para almacenar todos los archivos, carpetas y otros recursos que le interesan.
Proyecto Git: también es uno de los recursos en el repositorio de Git y su uso principal es administrar los proyectos con un tablero visual. Si crea un proyecto en Git Repository, cree un tablero visual como un tablero Kanban para administrar el proyecto.
De esta manera, puede tener múltiples proyectos en un repositorio.
Tienes la opción de añadir valor a nuestro contenido cooperando tu veteranía en las interpretaciones.