Skip to main content

Iniciio rápido para las propuestas de GitHub

Sigue esta guía interactiva breve para aprender sobre las GitHub Issues.

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 propuesta nueva y agregarás una lista de tareas para rastrear sub-tareas. Tambén aprenderás cómo agregar etiquetas, hitos, asignados y proyectos para comunicar los metadatos sobre tu propuesta.

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 habilitadas las propuestas. Para más información sobre cómo crear un repositorio, consulta "Crear un repositorio nuevo". Para más información sobre cómo habilitar las incidencias si están deshabilitadas en el repositorio, consulta "Inhabilitar propuestas".

Abrir una propuesta en blanco

Primero, crea una propuesta. Hay varias formas de crear una propuesta; puedes elegir el método más conveniente para tu flujo de trabajo. Este ejemplo utilizará la IU de GitHub. Para más información sobre otras formas de crear una incidencia, consulta "Crear una propuesta".

  1. En GitHub.com, navega a la página principal del repositorio.

  2. Debajo del nombre del repositorio, haga clic en Problemas.

    Captura de pantalla de la página principal de un repositorio. En la barra de navegación horizontal, una pestaña, con la etiqueta "Problemas", se destaca en naranja oscuro.

  3. Haz clic en Nueva propuesta.

  4. 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

Otorga un título descriptivo a tu propuesta. El título debe convenir el tema de la propuesta 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 obtener más información, vea «Escribir en GitHub».

Captura de pantalla del nuevo formulario de incidencias, con el título y el cuerpo rellenados.

Agregar una lista de tareas

Puede ser útil desglosar propuestas grandes den tareas más pequeñas o rastrear varias propuestas relacionadas en una sola propuesta más grande. Para agregar una lista de tareas a la incidencia, use [ ] como prefijo de los elementos de lista. Referencia las propuestas existentes por número de propuesta o URL. Puedes utilizar texto simple para rastrear las tareas que no tengan una propuesta correspondiente y convertirlas en propuestas posteriormente. Para obtener más información, vea «Acerca de las listas de tareas».

Captura de pantalla del nuevo formulario de la incidencia, con el título y el cuerpo rellenados. El cuerpo incluye markdown para una lista de tareas.

Agregar etiquetas

Agrega una etiqueta para categorizar tu propuesta. Por ejemplo, podría usar una etiqueta bug y otra good first issue para indicar que una incidencia es un error que un colaborador primerizo pudiera detectar. Los usuarios pueden filtrar las propuestas por etiqueta para encontrar todas aquellas que tengan una etiqueta específica.

Puedes utilizar las etiquetas predeterminadas o puedes crear una nueva. Para obtener más información, vea «Administrar las etiquetas».

Captura de pantalla del nuevo formulario de incidencias. En la barra lateral derecha, la sección "Etiquetas" aparece resaltada en naranja oscuro.

Agregar hitos

Puedes agregar un hito para rastrear la propuesta como parte de un objetivo basado en una fecha. Un hito mostrará el progreso de las propeustas conforme se acerce la fecha objetivo. Para obtener más información, vea «Acerca de los hitos».

Captura de pantalla del nuevo formulario de incidencias. En la barra lateral derecha, la sección "Hitos" aparece resaltada en naranja oscuro.

Asignar la propuesta

Para comunicar la responsabilidad, puedes asignar la propeusta a un miembro de tu organización. Para obtener más información, vea «Asignar propuestas y solicitudes de extracción a otros usuarios de GitHub».

Captura de pantalla del nuevo formulario de incidencias. En la barra lateral derecha, la sección "Usuarios asignados" aparece resaltada en naranja oscuro.

Agregar la propuesta a un proyecto

Puedes agregar la incidencia a un proyecto existente y rellenar los metadatos del proyecto. Para más información sobre los proyectos, consulta "Acerca de Projects".

Captura de pantalla del nuevo formulario de incidencias. En la barra lateral derecha, la sección "Proyectos" aparece resaltada en naranja oscuro.

Emitir tu propuesta

Haga clic en Enviar nueva incidencia para crear la incidencia. Puedes editar cualquiera de los campos anteriores después de crear la propuesta. Tu propuesta tiene una URL única que puedes compartir con los miembros del equipo o referenciar en otras propuestas o solicitudes de cambio.

Comunicar

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 obtener más información, vea «Escribir en GitHub».

Captura de pantalla de un comentario de incidencia. El encabezado dice "octocat acaba de comentar" y el cuerpo dice "@hubot También es necesario actualizar la lógica del cohete?"

Pasos siguientes

Puedes utilizar las propuestas para una amplia gama de propósitos. Por ejemplo:

  • Rastrear ideas
  • Recolectar retroalimentación
  • Planear tareas
  • Notificación de errores

Estos son algunos recursos útiles para que realice los siguientes pasos con GitHub Issues: