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
- En GitHub Enterprise Server, visita la página principal del repositorio.
- Debajo del nombre de tu repositorio, da clic en Propuestas.
- Haz clic en Propuesta nueva.
- Si tu repositorio utiliza plantillas, haz clic en Iniciar junto al tipo de propuesta que te gustaría abrir. O 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.
- Teclea un título y descripción para tu informe de problemas.
- 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.
- 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 Enterprise Server 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.
- Navega al comentario desde el cual te gustaría abrir una propuesta.
- Dentro del comentario, da clic en .
- Haz clic en Reference in new issue (Referencia en la propuesta nueva).
- Usa el menú desplegable "Repository" (Repositorio) y selecciona el repositorio donde desees abrir la propuesta.
- Escribe un título descriptivo y un cuerpo para la propuesta.
- Haz clic en Create issue (Crear propuesta).
- 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.
- 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.
- En GitHub Enterprise Server, visita la página principal del repositorio.
- 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.
- 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.
- 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.
- Para seleccionar una única línea del código, haz clic en el número de línea para resaltarla.
- Hacia la izquierda del rango de código, haz clic en . En el menú desplegable, da clic en Referenciar en nuevo informe de problemas.
- Teclea un título y descripción para tu informe de problemas.
- 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.
- 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 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 consulta | Ejemplo |
---|---|
título | https://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". |
cuerpo | https://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. |
etiquetas | https://github.com/octo-org/octo-repo/issues/new?labels=help+wanted,bug crea una propuesta con las etiquetas "help wanted" y "bug". |
hito | https://github.com/octo-org/octo-repo/issues/new?milestone=testing+milestones crea una propuesta con el hito "probando hitos". |
asignatarios | https://github.com/octo-org/octo-repo/issues/new?assignees=octocat crea una propuesta y la asigna a @octocat. |
proyectos | https://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. |
plantilla | https://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". |