Introducción
Esta guía te muestra cómo utilizar las GitHub Issues para planear y rastrear un trabajo. En esta guía, crearás una incidencia y la dividirás en subincidencias. También aprenderás a agregar etiquetas, tipos de incidencias, hitos, usuarios asignados y proyectos para comunicar metadatos sobre la incidencia.
Requisitos previos
Para crear una propuesta, necesitas un repositorio. Puedes utilizar un repositorio existente al cual tengas acceso de escritura o puedes crear un repositorio nuevo. Los miembros de una instancia de empresa con usuarios administrados solo pueden realizar cambios en los repositorios que formen parte de la empresa. El repositorio debe tener habilitadas las propuestas. Para más información sobre cómo crear un repositorio, consulta AUTOTITLE. Para obtener más información sobre cómo habilitar las incidencias si están deshabilitadas en el repositorio, consulte AUTOTITLE.
Abrir una propuesta en blanco
Primero, crea una propuesta. Hay varias formas de crear una incidencia; puedes elegir el método más conveniente para tu flujo de trabajo. Este ejemplo utilizará la IU de GitHub. Para obtener más información sobre otras formas de crear una incidencia, consulte AUTOTITLE.
-
En GitHub, navegue hasta la página principal del repositorio.
-
Debajo del nombre del repositorio, haz clic en Issues.
-
Haz clic en Nueva propuesta.
-
En este ejemplo, comenzaremos con una propuesta en blanco. Es posible que en el repositorio se usen plantillas de incidencia y formularios de incidencia para animar a los colaboradores a proporcionar información específica. Si el repositorio cuenta con plantillas de incidencia, haga clic en Abrir una incidencia en blanco.
Llenar la información
Da a tu problema un título descriptivo. El título debe transmitir de qué trata el problema a primera vista.
Agrega una descripción que explique el propósito de la propuesta, incluyendo cualquier detalle que pueda ayudar a resolverla. Por ejemplo, si este es un informe de errores, describe los pasos para reproducir dicho error, cuál es el resultado que se espera y cuál es el resultado real.
Puedes utilizar el lenguaje de marcado apra agregar formato, enlaces, emojis y más. Para más información, consulta AUTOTITLE.
Agregar una lista de tareas
También puedes utilizar texto sin formato para realizar el seguimiento de tareas que no tengan una incidencia correspondiente y convertirlas en incidencias posteriormente. Para más información, consulta AUTOTITLE.
Asignar el problema
Para comunicar la responsabilidad, puedes asignar la incidencia a un miembro de tu organización. Consulta AUTOTITLE.
Agregar etiquetas
Agrega una etiqueta para categorizar tu propuesta. Por ejemplo, podrías usar una etiqueta y otra para indicar que una incidencia es un error que un colaborador primerizo pudiera detectar. Los usuarios pueden filtrar los problemas por etiqueta para encontrar todos aquellos que tengan una etiqueta específica.
Puedes utilizar las etiquetas predeterminadas o puedes crear una nueva. Para más información, consulta AUTOTITLE.
Adición de tipos de incidencias
Puedes agregar un tipo de incidencia para clasificar el trabajo en toda la organización. Consulta AUTOTITLE.
Agregar el problema a un proyecto
Puedes agregar el problema a un proyecto existente y rellenar los metadatos del proyecto. Para obtener más información acerca de los Proyectos, consulta AUTOTITLE.
Agregar hitos
Puedes agregar un hito para rastrear el problema como parte de un objetivo basado en fechas. Un hito muestra el progreso de los problemas conforme se acerca la fecha objetivo. Consulta AUTOTITLE.
Enviar tu problema
Haga clic en Enviar nueva incidencia para crear la incidencia. Puedes editar cualquiera de los campos anteriores después de crear el problema. Tu propuesta tiene una URL única que puedes compartir con los miembros del equipo o referenciar en otras propuestas o solicitudes de cambio.
Adición de subtareas
Puedes agregar subincidencias a una incidencia para dividir rápidamente partes más grandes del trabajo en incidencias más pequeñas. Las subincidencias agregan compatibilidad con jerarquías de incidencias en GitHub mediante la creación de relaciones entre las incidencias. Puede crear varios niveles de subincidencias que representen con precisión el proyecto si divide las tareas exactamente con el nivel de detalle que usted y el equipo necesitan. Consulta AUTOTITLE y AUTOTITLE.
Adición de dependencias de incidencias
Puedes definir relaciones de bloqueo entre incidencias utilizando dependencias de tareas. Las dependencias de incidencias te permiten identificar incidencias que bloquean o están bloqueadas por otro trabajo. Consulta AUTOTITLE.
Comunicación
Después de que se crea tu propuesta, sigue la conversación agregando comentarios a ella. Puede a colaboradores o equipos para que se fijen en un comentario. Para vincular problemas relacionados en el mismo repositorio, puede escribir parte del título o palabras clave del problema y luego hacer clic en el problema que desea vincular. Para más información, consulta AUTOTITLE.
Pasos siguientes
Puedes utilizar las propuestas para una amplia gama de propósitos. Por ejemplo:
- Seguimiento de ideas
- Recolectar retroalimentación
- Planear tareas
- Notificación de errores
Para dividir la incidencia en tareas más fáciles de administrar, puede agregar varios niveles de subincidencias. Consulta AUTOTITLE.
Estos son algunos recursos útiles para que realice los siguientes pasos con GitHub Issues:
- Para obtener más información sobre los problemas, consulta AUTOTITLE.
- Para obtener información sobre los aspectos básicos para usar las herramientas de planeación y seguimiento de GitHub, consulta AUTOTITLE.
- Para obtener más información sobre cómo los proyectos pueden ayudarte con la planificación y el seguimiento, consulta AUTOTITLE.
- Para más información sobre el uso de plantillas de incidencia y formularios de incidencia para animar a los colaboradores a proporcionar información específica, consulta AUTOTITLE.