Crear una propuesta

Las propuestas pueden crearse de varias formas, así que puedes elegir el método más conveniente para tu flujo de trabajo.

¿Quién puede utilizar esta característica?

People with read access can create an issue in a repository where issues are enabled. Los miembros de una instancia de empresa con usuarios administrados solo pueden realizar cambios en los repositorios que formen parte de la empresa.

En este artículo

Las propuestas se pueden usar para hacer un seguimiento de los errores, mejoras u otras solicitudes. Para obtener más información, vea «Acerca de las propuestas».

Los administradores de repositorio pueden inhabilitar las propuestas de un repositorio. Para obtener más información, vea «Inhabilitar propuestas».

Crear una propuesta desde un repositorio

  1. En GitHub, navegue hasta 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. Si en el repositorio se usan plantillas de incidencia, haga clic en Comenzar junto al tipo de incidencia que quiera abrir.

    Si el tipo de problema que desea abrir no se incluye en las opciones disponibles, haga clic en Abrir una incidencia en blanco.

    Captura de pantalla del selector de plantillas para una incidencia. Debajo de las opciones de plantilla, un vínculo, con la etiqueta "Abrir una incidencia en blanco", se resalta en naranja oscuro.

  5. En el campo "Título", escriba un título para la incidencia.

  6. En el campo cuerpo del comentario, escriba una descripción de la incidencia.

  7. Si es un mantenedor de proyectos, puede asignar la incidencia a alguien, agregarla a proyecto, asociarla a un hito, establecer el tipo de incidencia o aplicar una etiqueta.

  8. Cuando haya terminado, haga clic en Enviar nueva incidencia.

Crear una propuesta con GitHub CLI

GitHub CLI es una herramienta de código abierto para usar GitHub desde la línea de comandos del equipo. Cuando trabajas desde la línea de comandos, puedes utilizar el GitHub CLI para ahorrar tiempo y evitar cambiar de contexto. Para más información sobre GitHub CLI, consulta "Acerca del CLI de GitHub".

Para crear una incidencia, use el subcomando gh issue create. Para omitir las preguntas interactivas, incluya las marcas --body y --title.

gh issue create --title "My new issue" --body "Here are more details."

También puedes especificar asignados, etiquetas, hitos y proyectos.

gh issue create --title "My new issue" --body "Here are more details." --assignee @me,monalisa --label "bug,help wanted" --project onboarding --milestone "learning codebase"

Crear una propuesta desde un comentario

Puedes abrir una propuesta nueva desde un comentario en otra propuesta o solicitud de cambios. Cuando abres un informe de problemas desde un comentario, este informe contiene un fragmento de código que muestra en dónde se hizo el comentario originalmente.

  1. Navega al comentario desde el cual te gustaría abrir una propuesta.

  2. En ese comentario, haz clic en .

    Captura de pantalla de un comentario en una solicitud de incorporación de cambios. El botón "Habilitar" está resaltado en naranja oscuro.

  3. Haga clic en Referencia en la nueva incidencia.

  4. Usa el menú desplegable "Repositorio" y selecciona el repositorio donde quieres abrir el problema.

  5. Escribe un título descriptivo y un cuerpo para la propuesta.

  6. Haga clic en Crear incidencia.

  7. Si es un mantenedor de proyectos, puede asignar la incidencia a alguien, agregarla a proyecto, asociarla a un hito, establecer el tipo de incidencia o aplicar una etiqueta.

  8. Cuando haya terminado, haga clic en Enviar nueva incidencia.

Crear una propuesta desde el código

Puedes abrir una nueva propuesta desde una línea específica o líneas de código en un archivo o solicitud de extracción. Cuando abres una propuesta desde el código, la propuesta contiene un fragmento de código que muestra la línea o rango de código que elegiste. Solo puedes abrir una propuesta en el mismo repositorio donde se almacena el código.

  1. En GitHub, navegue hasta la página principal del repositorio.

  2. Ubica el código que deseas hacer referencia en una propuesta:

    • Para abrir una propuesta acerca de un código en un archivo, navega hasta el archivo.
    • Para abrir una incidencia sobre el código de una solicitud de incorporación de cambios, ve a la solicitud de incorporación de cambios y haz clic en Archivos modificados. Luego, desplácese hasta el archivo que contiene el código que quiera incluir en el comentario y haga clic en Ver.

  3. Decide si seleccionar una única línea o un intervalo.

    • Para seleccionar una única línea del código, haz clic en el número de línea para resaltarla.
    • Para seleccionar un rango de código, haz clic en el número de la primera línea del rango para resaltar la línea del código. Después, desplace el mouse sobre la última línea del rango del código, presione Mayús y haga clic en el número de línea para resaltar el rango.

  4. A la izquierda del intervalo de código, haz clic en . En el menú desplegable, haz clic en Referencia en la nueva incidencia.

    Captura de pantalla de un archivo, con 8 líneas seleccionadas. A la izquierda de la primera línea seleccionada, un botón etiquetado con un icono de kebab está resaltado en naranja oscuro.

  5. En el campo "Título", escriba un título para la incidencia.

  6. En el campo cuerpo del comentario, escriba una descripción de la incidencia.

  7. Si es un mantenedor de proyectos, puede asignar la incidencia a alguien, agregarla a proyecto, asociarla a un hito, establecer el tipo de incidencia o aplicar una etiqueta.

  8. Cuando haya terminado, haga clic en Enviar nueva incidencia.

Crear una propuesta a partir de un debate

Las personas con permiso de clasificación en un repositorio pueden crear una propuesta a partir de un debate.

Cuando creas una propuesta a partir de un debate, el contenido de la publicación del debate se incluirá automáticamente en el cuerpo de la propuesta y cualquier etiqueta se retendrá. El crear una propuesta a partir de un debate no convertirá el debate en una propuesta ni borrará el debate existente. Para más información sobre GitHub Discussions, consulta "Acerca de los debates".

  1. En el nombre de la organización o el repositorio, haz clic en Debates.

    Captura de pantalla de las pestañas de un repositorio de GitHub. La opción "Debates" está resaltada en naranja oscuro.

  2. En la lista de debates, da clic en el debate que quieras ver.

  3. En la barra lateral derecha, haz clic en Crear incidencia a partir del debate.

    Captura de pantalla de la barra lateral en un debate. La opción "Crear incidencia a partir del debate" se resalta en color naranja oscuro.

  4. En el campo "Título", escriba un título para la incidencia.

  5. En el campo cuerpo del comentario, escriba una descripción de la incidencia.

  6. Si es un mantenedor de proyectos, puede asignar la incidencia a alguien, agregarla a proyecto, asociarla a un hito, establecer el tipo de incidencia o aplicar una etiqueta.

  7. Cuando haya terminado, haga clic en Enviar nueva incidencia.

Creación de una incidencia desde un proyecto

Puedes crear rápidamente incidencias sin salir del proyecto. Al usar una vista agrupada por un campo, la creación de una incidencia en ese grupo establecerá automáticamente el campo de la nueva incidencia en el valor del grupo. Por ejemplo, si agrupas la vista por "Status", al crear un problema en el grupo "Todo", el "Status" de la nueva incidencia se establecerá automáticamente en "Todo". Para más información sobre los proyectos, consulta "Acerca de Projects".

  1. Navegar a tu proyecto.

  2. En la parte inferior de una tabla, de un grupo de elementos o de una columna en el diseño de tablero, haz clic en .

    Captura de pantalla que muestra la fila inferior de una vista de tabla. El botón "+" está resaltado con un contorno naranja.

  3. Haz clic en Crear nueva incidencia.

  4. En la parte superior del cuadro de diálogo "Crear nuevo problema", seleccione el repositorio donde quieres crear la nueva incidencia.

    Captura de pantalla que muestra el cuadro de diálogo "Crear nueva incidencia".

  5. Debajo de la lista desplegable del repositorio, escribe un título para la nueva incidencia.

  6. Opcionalmente, usa los campos debajo del campo de título para establecer los usuarios asignados, las etiquetas y los hitos, y agrega la nueva incidencia a otros proyectos.

  7. Opcionalmente, escribe una descripción para la incidencia

  8. Opcionalmente, si quieres crear más incidencias, selecciona Crear más y el cuadro de diálogo se volverá a abrir al crear la incidencia.

  9. Haga clic en Crear.

Crear una propuesta desde un elemento de lista de tareas

Dentro de una propuesta, puedes utilizar las listas de tareas para desglosar el trabajo en tareas más pequeñas y rastrear todo el conjunto del trabajo hasta que se complete. Si se requiere más rastreo o debate, puedes convertir la tarea en una propuesta si deslizas el puntero del mouse sobre la tarea y haces clic en en la esquina superior derecha de la misma. Para obtener más información, vea «Acerca de las listas de tareas».

Crear una propuesta desde una consulta de URL

Puedes consultar parámetros para abrir propuestas. Los parámetros de consulta son partes opcionales de una URL que puedes personalizar para compartir una vista de página web específica, como los resultados de filtro de búsqueda o una plantilla de propuestas en GitHub. Para crear tus propios parámetros de consulta, debes hacer coincidir el par de clave y valor.

Sugerencia: También puede crear plantillas de incidencias que se abran con etiquetas predeterminadas, usuarios asignados y un título de incidencia. Para obtener más información, vea «Utilizar plantillas para promover informes de problemas y solicitudes de extracción útiles».

Debes tener los permisos adecuados para cualquier acción para usar el parámetro de consulta equivalente. Por ejemplo, debe tener permiso para agregar una etiqueta a una incidencia para usar el parámetro de consulta labels. Para obtener más información, vea «Roles de repositorio para una organización».

Si crea una URL no válida con los parámetros de consulta o si no tiene los permisos adecuados, la URL devolverá una página de error 404 Not Found. Si crea una dirección URL que supere el límite del servidor, la dirección URL devolverá una página de error 414 URI Too Long.

Parámetro de consultaEjemplo
titlehttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report crea una incidencia con la etiqueta "error" y el título "Nuevo informe de errores".
bodyhttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. crea una incidencia con el título "Nuevo informe de errores" y el comentario "Describir el problema" en el cuerpo de la incidencia.
labelshttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug crea una incidencia con las etiquetas "help wanted" y "bug".
milestonehttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones crea una incidencia con el hito "prueba de hitos".
assigneeshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat crea una incidencia y la asigna a @octocat.
projectshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 crea una incidencia con el título "Corrección de errores" y la agrega al proyecto 1 de la organización.
templatehttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md crea una incidencia con una plantilla en el cuerpo. El parámetro de consulta template funciona con plantillas almacenadas en un subdirectorio ISSUE_TEMPLATE dentro del directorio raíz, docs/ o .github/ de un repositorio. Para obtener más información, vea «Utilizar plantillas para promover informes de problemas y solicitudes de extracción útiles».

También puedes usar parámetros de consulta de dirección URL para rellenar campos de texto personalizados definidos en plantillas de formulario de problemas. Los parámetros de consulta para los campos de formulario de incidencias también se pueden pasar al selector de plantillas de incidencias. Para obtener más información, vea «Sintaxis para el modelado de formato de GitHub».

Crear una propuesta desde una alerta del code scanning

Nota: El seguimiento de las alertas de code scanning se encuentra en versión preliminar pública y está sujeto a cambios.

Esta característica es compatible con la ejecución nativa de análisis mediante GitHub Actions o de forma externa mediante la infraestructura de CI/CD existente, así como herramientas de code scanning de terceros, pero no herramientas de seguimiento de terceros.

Si usa incidencias para realizar el seguimiento del trabajo y clasificarlo por orden de prioridad, puede utilizar para realizar el seguimiento de las alertas de code scanning. Para más información sobre cómo crear incidencias para hacer un seguimiento de las alertas de code scanning, consulta "Rastrear alertas del escaneo de código en propuestas utilizando listas de tareas".

Información adicional