class: center, middle, inverse, title-slide # Python II y GitHub ### Licenciatura en Ciencias Genómicas, UNAM ### First version: 2022-07-08; Last update: 2023-08-21 --- <style type="text/css"> /* From https://github.com/yihui/xaringan/issues/147 */ .scroll-output { height: 80%; overflow-y: scroll; } /* https://stackoverflow.com/questions/50919104/horizontally-scrollable-output-on-xaringan-slides */ pre { max-width: 100%; overflow-x: scroll; } </style> ## Contenido 1. [Especificar versiones en Git con tag](./leccion1/1-Etiquetas.html) 2. [Trabajar con ramas en Git: git branch](./leccion2/2-Ramas.html) 3. [Manejo de issues en GitHub](3-issues.html) 4. [Gestión de un proyecto con GitHub](./leccion4/4-project.html) --- # "Issues" en GitHub ## Objetivo Al finalizar la lección, podremos crear "issues" y dar seguimiento al mantenimiento del software, a reportes de errores, ideas y propuestas de cambios en nuestros repositorios GitHub, así como planificación de actividades. <img src="img/sample_issue.png" width="500px" style="display: block; margin: auto;" /> --- ## Introducción Pensemos en que tenemos nuestro desarrollo de software en GitHub o bien que estamos colaborando en un repositorio. Puede que haya muchas personas involucradas y necesitamos organizar el trabajo de desarrollo o que simplemente nosotros necesitemos organizarnos. Existen tareas importantes por realizar, como: - Dar mantenimiento al software - Resolver errores - Crear nuevas funcionalidades - Realizar actualizaciones Así como dar seguimiento a la resolución de aquellos _pull requests_ que hayan sido enviados al repositorio. Los __issues__ en GitHub ayudan a gestionar aquellas actividades que permitan tener el _control y comunicación entre nosotros mismos, así como con el equipo de trabajo y con los usuarios del repositorio_. --- ## Issues .full-width[.content-box-red[Un _issue_ te permiten rastrear el trabajo en GitHub.]] Los _issues_ representan una herramienta de seguimiento que está integrada con los repositorios de GitHub. Los issues se usan para concentrarse en tareas importantes y mantener los planes actualizados simultáneamente. Todo equipo ágil necesita organizar su trabajo, pero nadie quiere dejar de trabajar para realizar un seguimiento del mismo. <img src="img/issues.png" width="350px" style="display: block; margin: auto;" /> --- ## Issues Los issues incluyen: - Título - Descripción - Asignación - Etiquetas - `@`menciones <img src="img/estruc-issues.png" width="700px" style="display: block; margin: auto;" /> --- ## Uso de los issues **Escenario 1** Haciedo uso del software (programa en particular, librería, etc.) Por ejemplo: - Enviar un mensaje al desarrollador para solicitar ayuda en la resolución de un error - Solicitar ayuda en la configuración del software - Preguntar sobre el formato de datos de entrada del software **Escenario 2** Contribuyendo a la mejora del software por medio de pull request Por ejemplo: - Enviar correcciones a la documentación del software - Proponer mejoras al software - Corrección de errores --- ## Creando issues - Título - Descripción - Asignación - `@`menciones - Etiquetas <img src="img/issues-new.png" width="700px" style="display: block; margin: auto;" /> --- ## Tablero de issues Una vez que hemos creado un issue podemos ver en la sección Issues. Podemos ver que tenemos: - Filtros - Etiquetas <img src="img/tablero-issues.png" width="700px" style="display: block; margin: auto;" /> --- ## Conclusión _GitHub issues_ permite dar seguimiento de "problemas"" y dicha funcionalidad está disponible en todos los repositorios de GitHub. A tráves de los _issues_ podemos "discutir" con el mundo las cosas que construimos. Los _issues_ en GitHub son usados comúnmente para reportar errores y solicitud de nuevas funcionalidades. Con los _issues_ podemos organizar aún más el trabajo con etiquetas, y realizar un seguimiento las tareas. _¡Usa los issues para comunicarte y controlar el trabajo!_