Introducción
En esta guía se muestra cómo usar GitHub Issues para planear y realizar un seguimiento de un trabajo. En esta guía, creará una nueva incidencia. También aprenderá a añadir etiquetas de incidencia, hitos, personas asignadas 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. El repositorio debe tener las incidencias activadas. Para obtener más información sobre cómo crear un repositorio, consulte Crear un repositorio nuevo. Para obtener más información sobre cómo habilitar las incidencias si están deshabilitadas en el repositorio, consulte Inhabilitar propuestas.
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. En este ejemplo se usará la GitHubinterfaz de usuario. Para obtener más información sobre otras formas de crear una incidencia, consulte Crear un problema.
-
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. Tu repositorio puede usar plantillas de incidencias 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 Escribir en GitHub.
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 Creación de dependencias de incidencias.
Comunicación
Después de que se crea tu propuesta, sigue la conversación agregando comentarios a ella. Puede @mention a colaboradores o equipos para que se fijen en un comentario. Para vincular las incidencias relacionadas en el mismo repositorio, puede escribir # seguido de parte del título de la incidencia y luego hacer clic en la que quiera vincular. Para más información, consulta Escribir en GitHub.
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
Estos son algunos recursos útiles para realizar los pasos siguientes con GitHub Issues:
- Para más información sobre las incidencias, consulta Acerca de los problemas.
- Para obtener información sobre los aspectos básicos para el uso GitHubde las herramientas de planificación y seguimiento, consulte Planear y rastrear el trabajo para tu equipo o proyecto.
- Para obtener más información sobre cómo los proyectos pueden ayudarte con la planificación y el seguimiento, consulta Más información sobre Projects.
- Para obtener más información sobre el uso de plantillas de problemas para animar a los colaboradores a proporcionar información específica, consulte Utilizar plantillas para promover informes de problemas y solicitudes de extracción útiles.