5 Projects
5.1 ¿Qué son los proyectos de GitHub?
Los proyectos de GitHub son una herramienta de gestión que ayuda a organizar y rastrear el trabajo, integrando con las otras herramientas que ya hemos visto de GitHub (como repositorios, issues, etc).
Los proyectos forman parte de una cuenta (personal u organización). Un proyecto no “pertenece” a un repositorio, sino que está vinculado a uno. Esto permite gestionar múltiples repositorios dentro de un mismo proyecto, facilitando la organización y seguimiento del trabajo.
5.2 Creando un proyecto en GitHub
Los proyectos pueden ser creados vinculados a un repositorio utilizando la pestaña “Projects”, y luego “New Project”. También es posible vincular un proyecto existente a un repositorio.
En el siguiente ejemplo, vamos a crear un nuevo proyecto vinculado al repositorio:
El siguiente paso es elegir una plantilla inicial. Recomendamos comenzar con “Planificación del equipo”, ¡pero puedes explorar otras plantillas después!
Después debemos añadir un nombre al proyecto, y luego hacer clic en “Create project”:
¡Tenemos un proyecto creado!
Vamos explorar un poco cómo trabajar con este proyecto.
5.3 Añadir columnas
Usando la plantilla elegida, comenzamos con 3 columnas: To do (por hacer), Doing (en progreso), Done (hecho).
Este formato es conocido como Kanban, y es muy útil para visualizar el flujo de trabajo y el estado de las tareas.
Si estas columnas no son suficientes, podemos crear nuevas columnas usando el botón de +
:
Podemos configurar algunos elementos para la columna, como: nombre (Label text), color (Color) y descripción (Description):
¡Ahora la columna está creada!
Sin embargo, tiene más sentido que sea la primera columna presentada. Podemos mover la columna arrastrándola.
El siguiente paso es añadir contenidos al proyecto.
5.4 Añadir elementos
Para añadir elementos a nuestro proyecto, podemos hacer clic en + Add Item
en la parte inferior de la columna donde queremos añadir el elemento.
Podemos añadir un elemento de las siguientes maneras:
Escribiendo un breve mensaje (que puede ser convertido en una Issue);
A partir de una Issue existente;
A partir de un Pull Request (PR) existente (hablaremos de PR’s en breve, pero es una herramienta importante para la colaboración en proyectos).
Vamos a empezar añadiendo un elemento con un mensaje simple. Para ello, hacemos clic en + Add Item
, escribimos un breve mensaje sobre la tarea y luego presionamos enter (o hacemos clic en “Create a Draft”):
Otra forma de añadir elementos es agregar una Issue o Pull Request existente. Para ello, hacemos clic en + Add Item
, y en la caja de mensajes escribimos #
. GitHub nos ofrecerá algunas opciones de repositorio, y debemos elegir el repositorio donde se encuentra la Issue/Pull Request que queremos añadir. Después de elegir el repositorio, GitHub presentará una lista de Issues y Pull Requests que podemos seleccionar para añadir al proyecto.
5.4.1 Complementar los elementos
Cuando creamos Issues y Pull Requests, podemos añadir etiquetas (labels), personas responsables (Assignees), hitos del proyecto (Milestones), entre otros.
Al añadir esta información, aparecerá en los elementos del proyecto, facilitando la visualización y organización del trabajo.
Vea el ejemplo de añadir labels y responsables a un Pull Request:
Y luego verificar cómo el elemento aparece en el proyecto:
Podemos configurar qué información queremos ver en los elementos del proyecto (recuerde guardar los cambios haciendo clic en Save
):
5.5 Proyectos Públicos y Privados
Al igual que los repositorios, los proyectos pueden ser públicos o privados.
Para cambiar la visibilidad de un proyecto, en la esquina superior derecha de la pantalla del proyecto, haga clic en ...
, y luego en Settings
para abrir la pantalla de configuración.
En la pantalla de configuración, al final de la página, podemos cambiar la visibilidad del proyecto:
5.6 Ejercicio
Cree un proyecto en GitHub, vinculado al repositorio creado en los ejercicios anteriores.
Añada algunas columnas y elementos al proyecto, y explore las funcionalidades disponibles.