Creación de Issues: Descripción, etiquetas (labels), asignación

En GitHub, los issues sirven para el seguimiento de tareas, reportes de errores y propuestas de mejoras en un proyecto.

Para crear un issue nuevo, se accede a la pestaña "Issues" del repositorio y se selecciona "New issue". Se completa un formulario donde se introduce un título y un cuerpo. Se recomienda utilizar markdown en el cuerpo para mejorar la legibilidad, incluyendo listas, enlaces y fragmentos de código si es necesario.

Las etiquetas o labels permiten categorizar y priorizar los issues. Al crear o editar un issue, se pueden asignar etiquetas que reflejen su naturaleza, como bug, enhancement o question. Se pueden aplicar múltiples etiquetas a un issue para una clasificación más precisa.

Asignar un issue a un colaborador se usa para designar responsabilidades. En la sección "Assignees" dentro del issue, se selecciona al miembro del equipo que se encargará de resolverlo. Solo se pueden asignar issues a usuarios que tengan acceso al repositorio.

Uso de identificadores de issues en mensajes de commit

Es importante integrar los identificadores de issues en los mensajes de commit para mantener un seguimiento entre los cambios realizados y los problemas que se están resolviendo. Al incluir el número del issue precedido por el símbolo #, se permite que GitHub vincule automáticamente el commit con el issue correspondiente.

Por ejemplo, si se está solucionando el issue número 42, el mensaje de commit puede ser:

git commit -m "#42 Corrige error en la validación de usuarios"

De esta manera, se puede navegar fácilmente entre el historial de commits y los issues relacionados.

Además, si se utilizan palabras clave como closes, fixes o resolves seguido del número del issue, se hará que GitHub cierre automáticamente el issue cuando el commit se incorpore a la rama principal. Un ejemplo sería:

git commit -m "#42 Añade validación de datos de entrada closes"

Se recomienda establecer convenciones en el equipo sobre cómo referenciar los issues en los commits.

En proyectos grandes, se aplica esta práctica para facilitar el seguimiento de las tareas y agilizar los procesos de revisión y auditoría del código.

Al trabajar con ramas, también es común nombrarlas utilizando el identificador del issue, por ejemplo, feature/42-mejora-algoritmo.

Uso de proyectos y tableros en GitHub

Los proyectos en GitHub ofrecen una manera de organizar y gestionar el trabajo en un repositorio. Mediante los tableros Kanban, se puede visualizar el progreso de los issues y pull requests.

Para crear un proyecto, se accede a la pestaña "Projects" del repositorio y se selecciona "New project". Se elige un template adecuado, como Kanban básico, y se asigna un nombre y descripción al proyecto. Una vez creado, el tablero permite añadir columnas como To Do, In Progress y Done para categorizar el estado de las tareas.

Se pueden agregar issues y pull requests al tablero mediante la opción Add cards. Al arrastrar y soltar las tarjetas entre columnas, se refleja el avance en el flujo de trabajo. Es posible automatizar estas acciones utilizando reglas que mueven las tarjetas en respuesta a eventos, como cambios de estado en los issues.

Los proyectos pueden ser gestionados no solo a nivel de repositorio, sino también a nivel de organización o usuario, permitiendo una visión más amplia de múltiples repositorios.

La asignación de responsables, etiquetas y fechas de vencimiento desde el tablero agiliza la gestión. Al hacer clic en una tarjeta, se accede directamente al issue o pull request asociado.

Además, GitHub Projects admite la integración con otras herramientas y puede ser personalizado mediante campos personalizados, proporcionando mayor flexibilidad. Se pueden crear nuevas vistas y filtros para enfocarse en aspectos específicos.

Para mejorar la comunicación, se suelen utilizar notificaciones y menciones en los comentarios de los issues. Esto garantiza que los miembros del equipo estén al tanto de las actualizaciones importantes.