Issues: organizar el trabajo
GitHub no es solo para guardar código. Trae una herramienta sencilla y muy útil para organizar todo lo que hay que hacer en un proyecto: los issues. Piensa en ellos como la lista de tareas y el buzón de sugerencias de tu proyecto, todo en uno.
Escucha la lección
¿Qué es un issue?
"Issue" en inglés significa asunto o incidencia. En GitHub, un issue es una nota sobre algo del proyecto: un fallo que hay que arreglar, una mejora que se quiere añadir, una duda, una idea. Cada cosa pendiente es un issue.
Crear uno es muy fácil: en la pestaña Issues del repositorio, pulsas "New issue", le pones un título claro y una descripción explicando de qué va. Y ya queda apuntado, a la vista de todos.
Lo que puedes hacer con cada issue
Un issue no es solo una nota suelta — puedes organizarlo:
- ›Comentarios: cualquiera puede responder y comentar, para discutir cómo resolverlo.
- ›Etiquetas (labels): le pones colores y categorías, como
error,mejora,urgente, para verlo de un vistazo. - ›Asignar a alguien: dices quién se encarga de ese issue.
- ›Cerrar: cuando está resuelto, lo cierras. Queda guardado, pero marcado como hecho.
Por qué te conviene usarlos
Los issues son la memoria ordenada de tu proyecto. En vez de tener en la cabeza "me parece que había un fallo en algún sitio", tienes una lista clara de lo que falta, lo que se está haciendo y lo que ya está resuelto.
- ›En equipo: son la forma de repartir el trabajo. Cada persona coge sus issues y todos ven en qué anda cada uno.
- ›Tú sola: funcionan como una lista de tareas estupenda para tu propio proyecto. Vas apuntando ideas y fallos, y los vas cerrando. Da mucha satisfacción ver la lista vaciarse.
Pequeño truco: cuando arreglas algo, en el mensaje del commit puedes escribir "cierra #5" (con el número del issue), y GitHub lo cierra solo y lo enlaza. Magia.
¿No programas? Te lo explico fácil · sin tecnicismos
Imagina que en la nevera de tu proyecto tienes una pizarra con notas adhesivas.
Cada nota es una cosa pendiente: "arreglar el botón rojo", "añadir la página de contacto", "preguntar a Marta por el logo". Eso es un issue: una notita de algo que hay que hacer o resolver.
Y como en una pizarra bien organizada, puedes ponerle colorines a las notas (las etiquetas), escribir quién se encarga de cada una (asignar), y quitarla cuando ya está hecha (cerrar).
Sirve para trabajar en equipo, claro, pero también para ti sola: es una lista de tareas de tu proyecto, ordenada y siempre a mano. Y poco hay tan satisfactorio como ir quitando notas de la pizarra.
Glosario
Issue
Elemento de seguimiento en GitHub para reportar errores, proponer mejoras o registrar tareas de un repositorio.
Una nota sobre algo del proyecto: un fallo, una idea o una tarea pendiente.
Etiqueta (label)
Marca de color y categoría que se asigna a issues y pull requests para clasificarlos (bug, enhancement, etc.).
Un colorín con categoría que le pones a cada issue para organizarlos de un vistazo.
Cerrar un issue
Marcar un issue como resuelto. Queda archivado pero consultable. Puede cerrarse manualmente o desde un commit.
Marcar una tarea como hecha. La nota se quita de la lista, pero queda guardada por si acaso.