Gestión de incidencias

Pasos para la gestión de incidencias:

Registro en github

Vamos a emplear la plataforma web de la nube de github.com, ofrece servicios gratuitos para proyectos públicos y es relativamente fácil de usar.

Para crear una cuenta en github:

• Accede a github.
• Pincha arriba a la derecha sobre "Sign up" para crear una cuenta.
• Especifica un usuario, se recomienda que uses como referencia el UVUS, es decir, tres letras de tu nombre, tres de tu primer apellido y tres de tu segundo apellido.
• Especifica dirección de correo.
• Especifica tu clave personal de acceso.
• Especifica "Unlimited public repositories for free" que te permite crear tantos repositorios públicos como quieras y pincha en "Continue".
• Sáltate la encuesta de uso, pincha en "Skip this step".

Tras esto, ya has creado una cuenta, que está pendiente de ser verificada.

Creando un nuevo proyecto

• Pincha arriba a la derecha en el símbolo "+" y sobre el desplegable marcha "New repository".
• Completa el nombre de tu nuevo repositorio.
• Pincha sobre "Initialize this repository with a README" (facilita mucho la configuración de cara a la práctica 3 sobre gestión de código con git).
• Ya dispones de un proyecto.

Creando una incidencia (issue)

Las incidencias nos permiten recoger información muy útil ya sea sobre una petición de nueva funcionalidad, una petición para resolver un fallo de programación (bug), así como cualquier tarea relacionada con el desarrollo que requiera la atención del equipo de desarrollo.

Para crear una incidencia:

• Pincha en la pestaña de "Issue", la que está entre "Code" y "Pull requests".
• A la derecha aparece un botón verde que dice "New Issue". Pincha sobre el para crear una nueva incidencia.
• Específica un título y haz una descripción de la incidencia.
• Pincha sobre el botón verde "Submit new issue" para crear la incidencia. A partir de entonces, la pestaña "Issue" indica con un número uno (1) que hay una incidencia pendiente de ser tratada, que aparece en estado "Open".
• Al pinchar sobre la incidencia, se pueden añadir más comentarios.

Asignando una incidencia

Es buena práctica asociar a un ingenier@ del equipo de desarrollo la incidencia que hemos abierto como tarea asignada de la que se hace responsable, para ello:

• Pulsa sobre "Assignee" y selecciona el nombre del usuario que se hace cargo de la incidencia. Si quieres añadir más desarrolladores al proyecto, pincha sobre "Settings" y después sobre "Collaborators" para buscar el nombre del usuario al que quieres añadir como colaborador a tu proyecto. Una vez añadido, puedes incluir en la lista de "Assignee".

Etiquetando una incidencia

Es importante establecer a qué categoría pertenece una incidencia, github ofrece las siguiente categorías:

• bug: La incidencia describe un fallo de programación en el software.
• duplicate: Ya existe otra incidencia que describe los mismo que esta.
• enhancement: Una solicitud de mejora en el software.
• good first issue: Esta incidencia es idonea para un desarrollador del equipo junior, o con menor experiencia en el software.
• help wanted: Esta incidencia describe una petición de ayuda.
• invalid: Esta incidencia es incorrecta, refleja una petición que no tiene sentido.
• question: Esta incidencia describe una pregunta a responder para el equipo de desarrollo.
• wontfix: Esta incidencia no tiene solución posible. Se emplea cuando se describe como incidencia un comportamiento que parece ser defectuoso, pero que en realidad es una funcionalidad. También se puede emplear para una incidencia que describe un problema, para la que no existe solución posible. Hay que tener una buena razón para etiquetar una incidencia de esta manera.

Github permite seleccionar múltiples categorías simultáneamente.

Recuerde que en una gestión de incidencias es común encontrar al menos estos tres elementos:

• Prioridad de la incidencia.
• Estado en el que se encuentra.
• Tipo de incidencia.

Estos tres aspectos deben ser gestionados cuando proponga su proyecto.

Creando hitos (milestones)

Los hitos (milestones) sirven para agrupar una serie de incidencias y establecer una fecha de entrega para ellas. Puedes crear un hito:

• Pulsando en la pestaña de "Issue".
• Luego, sobre el boton "Milestone" que aparece.
• Completa el titulo, descripcion y fecha de entrega.

Y pulsa sobre "Create Milestone".

Recibir notificaciones sobre esta incidencia

A la izquierda, aparece un botón que permite a cada usuario decidir notificaciones por email sobre cambios en el estado de esta incidencia.

Cerrando una incidencia

• Una vez la incidencia se dé por terminada, se pincha sobre "Close issue".
• Es posible reabrirla pinchando sobre "Reopen" issue.