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.

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

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

Los administradores de repositorio pueden inhabilitar las propuestas de un repositorio. Para obtener más información, consulta la sección "Inhabilitar propuestas".

Crear una propuesta desde un repositorio

  1. En GitHub, visita la página principal del repositorio.
  2. Debajo del nombre de tu repositorio, da clic en Propuestas. Pestaña de informe de problemas
  3. Haz clic en Propuesta nueva. Botón Nuevas propuestas
  4. Si tu repositorio utiliza plantillas, haz clic en Iniciar junto al tipo de propuesta que te gustaría abrir. Select the type of issue you want to createO haz clic en Abrir una propuesta en blanco si el tipo de propuesta que te gustaría abrir no se incluye en las opciones disponibles. Enlace para abrir una propuesta en blanco
  5. Teclea un título y descripción para tu informe de problemas. Un ejemplo de informe de problemas
  6. Si eres un mantenedor de proyecto, puedes asignar el informe de problemas a alguien, agregarlo a un tablero de proyecto, asociarlo con un hito, o aplicar una etiqueta.
  7. Cuando termines, da clic en Emitir nuevo informe de problemas.

Crear una propuesta con CLI de GitHub

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

Para crear una propuesta, utiliza el subcomando gh issue create. Para omitir los mensajes interactivos, incluye los marcadores --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. Dentro del comentario, da clic en . Botón Kebab en el comentario de la revisión de solicitud de extracción
  3. Haz clic en Reference in new issue (Referencia en la propuesta nueva). Referencia en el elemento del menú de propuestas nuevas
  4. Usa el menú desplegable "Repository" (Repositorio) y selecciona el repositorio donde desees abrir la propuesta. Repositorio desplegable para nueva propuesta
  5. Escribe un título descriptivo y un cuerpo para la propuesta. Título y cuerpo para la nueva propuesta
  6. Haz clic en Create issue (Crear propuesta). Botón para crear la nueva propuesta
  7. Si eres un mantenedor de proyecto, puedes asignar el informe de problemas a alguien, agregarlo a un tablero de proyecto, asociarlo con un hito, o aplicar una etiqueta.
  8. Cuando termines, da clic en Emitir nuevo informe de problemas.

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.

Fragmento de código representado en una propuesta abierta desde el código

  1. En GitHub, visita 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 propuesta acerca de un código en una solicitud de extracción, navega hasta la solicitud de extracción y haz clic en Files changed (Archivos modificados). Luego, desplázate hasta el archivo que contiene el código que deseas incluir en tu comentario y haz clic en Ver.
  3. Decide si seleccionar una única línea o un rango:
    • Para seleccionar una única línea del código, haz clic en el número de línea para resaltarla. Archivo con una única línea del código seleccionada
      • 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. Luego lleva el puntero hasta la última línea del rango del código, presiona Shift y haz clic en el número de línea para resaltar el rango. Archivo con un rango del código seleccionado
  4. Hacia la izquierda del rango de código, haz clic en . En el menú desplegable, da clic en Referenciar en nuevo informe de problemas. Menú Kebab con opción para abrir una propuesta nueva desde una línea seleccionada
  5. Teclea un título y descripción para tu informe de problemas. Un ejemplo de informe de problemas
  6. Si eres un mantenedor de proyecto, puedes asignar el informe de problemas a alguien, agregarlo a un tablero de proyecto, asociarlo con un hito, o aplicar una etiqueta.
  7. Cuando termines, da clic en Emitir nuevo informe de problemas.

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 obtener más información sobre los GitHub Discussions, consulta la sección "Acerca de los debates".

  1. Debajo de tu nombre de repositorio, da clic en Debates. Pestaña de "Debates" en un repositorio
  2. En la lista de debates, da clic en el debate que quieras ver. Debate en la lista de debates de un repositorio
  3. En la barra lateral derecha, haz clic en Crear propuesta a partir de un debate. Botón para crear una propuesta a partir de un debate
  4. Teclea un título y descripción para tu informe de problemas. Un ejemplo de informe de problemas
  5. Si eres un mantenedor de proyecto, puedes asignar el informe de problemas a alguien, agregarlo a un tablero de proyecto, asociarlo con un hito, o aplicar una etiqueta.
  6. Cuando termines, da clic en Emitir nuevo informe de problemas.

Crear una propuesta desde una nota de un tablero de proyecto

Si utilizas un tablero de proyecto para rastrear y priorizar tu trabajo, puedes convertir las notas del mismo en informes de problemas. Para obtener más información, consulta la sección "Acerca de los tableros de proyecto" y "Agregar notas a un tablero de proyecto".

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, consulta "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 puedes crear plantillas de propuestas que se abran con etiquetas, asignatarios y un título de propuesta predeterminados. Para obtener más información, consulta la sección "Utilizar plantillas para fomentar las propuestas y solicitudes de cambio útiles".

Debes tener los permisos adecuados para cualquier acción para usar el parámetro de consulta equivalente. Por ejemplo, debes tener permiso para agregar una etiqueta a una propuesta para usar el parámetro de consulta labels. Para obtener más información, consulta "Niveles de permiso del repositorio para una organización".

Si creas una URL inválida utilizando parámetros de consulta o si no tienes los permisos adecuados, la URL devolverá una página de error 404 Not Found. Si creas una URL que exceda el límite del servidor, esta devolverá una página de error 414 URI Too Long.

Parámetro de consultaEjemplo
títulohttps://github.com/octo-org/octo-repo/issues/new?labels=bug&title=New+bug+report crea una propuesta en la etiqueta "error" y el título "Nuevo informe de error".
cuerpohttps://github.com/octo-org/octo-repo/issues/new?title=New+bug+report&body=Describe+the+problem. crea una propuesta con el título "New bug report" y el comentario "Describe de problem" en el cuerpo de la misma.
etiquetashttps://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug crea una propuesta con las etiquetas "help wanted" y "bug".
hitohttps://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones crea una propuesta con el hito "probando hitos".
asignatarioshttps://github.com/octo-org/octo-repo/issues/new?assignees=octocat crea una propuesta y la asigna a @octocat.
proyectoshttps://github.com/octo-org/octo-repo/issues/new?title=Bug+fix&projects=octo-org/1 crea una propuesta con el título "Solución del problema" y la agrega al tablero de proyecto 1 de la organización.
plantillahttps://github.com/octo-org/octo-repo/issues/new?template=issue_template.md crea una propuesta con una plantilla en el cuerpo de la propuesta. El parámetro de consulta template funciona con plantillas almacenadas en un subdirectorio de ISSUE_TEMPLATE dentro de la raíz, el directorio docs/ o el directorio .github/ en un repositorio. Para obtener más información, consulta la sección "Utilizar plantillas para fomentar las propuestas y solicitudes de cambio útiles".

Leer más

¿Te ayudó este documento?

Política de privacidad

¡Ayúdanos a hacer geniales estos documentos!

Todos los documentos de GitHub son de código abierto. ¿Notas algo que esté mal o que no sea claro? Emite una solicitud de cambios.

Haz una contribución

O, aprende cómo contribuir.