Etiquetado de Issues
🎏 Las etiquetas o Label en el módulo de Issues de un proyecto GitHub hace parte fundamental para la gestión eficiente, para establecer una comunicación práctica y didáctica, permite la administración de Issues más fluida y transparente entre usuarios que interactúan indirectamente con repositorios Open Source.
En la comunidadad de Open Source Bancolombia se busca tener una clasificación de problemas o oportunidades de mejora que facilite la visibilidad e identificación que permita al usuario asimilar que tipo de Issue esta trabajando, como por ejemplo: Bug, vulnerabilidad, documentación, entre otros que detallaremos a continuación.
Clasificación de Issues
La implementación de clasificar las etiquetas o tipos de etiqueta es llevada a cabo en agrupar el problema según su naturaleza o origen.
Nota: se hace énfasis en agrupar o asociar las etiquetas en darles una identidad por medio de un color y un prefijo.
Etiquetas de Categorías
c: prefijo de la palabra “categoría”, permite categorizar reportes según su naturaleza y es identificada con el color verde claro.
c: documentation Reporta ítems relacionado a la documentación.
c: feature Reporta ítems relacionado a una mejora o nueva característica.
c: vulnerability Reporta ítems relacionado a una vulnerabilidad detectada.
c: bug Reporta ítem relacionado a un error o problema.
Etiquetas Generales
g: prefijo de la palabra “general”, son etiquetas genéricas disponibles para permita identificar reportes con asunto genérico para facilitar su organización y es identificado con el color azul claro.
g: good first issue Asocia esta etiqueta para expresar un buen trabajo en tu primer resolución de problema.
g: help wanted Asocia esta etiqueta para expresar que se requiere asignación.
g: in triage Reporta ítems en proceso de análisis antes de permitir asignación.
g: assigned for triage Reporta ítem escalado a un experto para un análisis más profundo antes de permitir asignación.
g: question Asocia esta etiqueta para expresar que el problema va enfocado más a un interrogante que aun problema.
Etiquetas de Resolución
r: prefijo de la palabra “resolución”, son etiquetas de cierre para dar por finalizado o cierre definitivo a un reporte y son identificados con el color rojo.
r: duplicade se cierra el caso por haber otro issue con el mismo reporte.
r: fixed se cierra el caso porque la solución se encuentra trabajando en otro issue.
r: solved se cierra el caso porque la solución se implementó desde otro issue.
r: invalid se cierra el caso porque se encuentra con invalidez.
r: timeout se cierra el caso por falta de detalles, que el autor no proporciono dentro del tiempo esperado.
r: wontfix caso cerrado porque no será solucionado.
Proceso de Triaje
Triaje es el estado inicial que obtiene todo issue o reporte creado en GitHub, la cual es el primer filtro antes de ser atendida por un colaborador. Es la validación inicial con base a los argumentos y validar su urgencia para luego otorgar una clasificación y asignación de demás etiquetas descriptivas. El proceso de triaje como primer paso de cada reporte nos permite depurar, filtrar, identificar, reportes mal creados, falta de argumentación, duplicados, críticos, urgentes para luego proceder a la atención adecuada.
A nivel de comunidad o de proyecto, este primer control en las issues, nos permite darle un manejo sólido y transparente de los tiques que son escalados y poder dar solución y mejor manejo de tiempos a responder las peticiones recibidas según la urgencia merecida gracias a la clasificaron asignada por el proceso de triaje.
Cabe mencionar que quienes realizan este análisis de triaje son los miembros de la comunidad que ejercen el rol de “Maintainer”.