Uso de GitHub Codespaces para solicitudes de incorporación de cambios

Puede usar GitHub Codespaces en el explorador web o en Visual Studio Code para crear solicitudes de incorporación de cambios, revisar las solicitudes de incorporación de cambios y dirigir los comentarios de revisión.

En este artículo

Usar un codespace para trabajar en una pull request te ofrece todas las ventajas de GitHub Codespaces. Para más información, consulta características de GitHub Codespaces.

Acerca de las solicitudes de incorporación de cambios en GitHub Codespaces

GitHub Codespaces proporciona muchas de las funcionalidades que podría necesitar para trabajar con solicitudes de incorporación de cambios:

  • Crear una solicitud de incorporación de cambios: use los comandos Terminal y Git o la vista "Control de código fuente", puede crear solicitudes de incorporación de cambios como lo haría en GitHub. Si el repositorio utiliza una plantilla de solicitud de incorporación de cambios, podrás utilizarla en la vista "Control de código fuente".
  • Apertura de una solicitud de incorporación de cambios: puede abrir una solicitud de incorporación de cambios existente en un codespace, siempre que tenga acceso al codespace y a la rama en la que se va a combinar.
  • Vista de una solicitud de incorporación de cambios: una vez que haya abierto una solicitud de incorporación de cambios en un espacio de código, puede usar la vista "GitHub solicitud de incorporación de cambios" para agregar comentarios de revisión y aprobar solicitudes de incorporación de cambios. También puede usar GitHub Codespaces para ver los comentarios de revisión.

Abrir una solicitud de extracción en Codespaces

  1. En el nombre del repositorio, haga clic en Solicitudes de incorporación de cambios.

  2. En la lista de solicitudes de incorporación de cambios, haga clic en la solicitud de incorporación de cambios que desea abrir en Codespaces.

  3. En el lado derecho de la pantalla, haga clic en Código.

  4. En la Codespaces pestaña , haga clic en .

    Captura de pantalla de la lista desplegable "Código" con la pestaña "Codespaces" seleccionada. Se muestra el mensaje "No hay codespaces". El botón de suma está resaltado.

    Se crea un espacio de código para la rama de solicitud de incorporación de cambios y se abre en el editor predeterminado para GitHub Codespaces.

Revisión de una pull request en Codespaces

  1. Con el editor predeterminado configurado como Visual Studio Code o Visual Studio Code en la Web, abra la solicitud de extracción en un codespace, como se ha descrito en Abrir una solicitud de extracción en Codespaces anteriormente en este artículo.

  2. En la barra de actividad, haga clic en el icono de solicitud de incorporación de cambios de Git para mostrar la barra lateral "GitHub Solicitud de incorporación de cambios". Este icono solo se muestra en la barra de actividades cuando se abre una solicitud de incorporación de cambios en un codespace.

    Captura de pantalla de la barra de actividad de VS Code. El puntero del mouse se mantiene sobre un icono que muestra la información sobre herramientas "Solicitud de incorporación de cambios de GitHub".

    Si abrió una solicitud de incorporación de cambios en un espacio de código y el icono de solicitud de incorporación de cambios no se muestra en la barra de actividad, asegúrese de que ha iniciado sesión en GitHub. Haga clic en el GitHub icono de la barra de actividades y, a continuación, haga clic en Iniciar sesión.

    Captura de pantalla de la barra lateral GitHub que muestra el botón "Iniciar sesión". El icono GitHub de la barra de actividad está resaltado con un contorno naranja.

  3. Para revisar los cambios realizados en un archivo específico, haga clic en el nombre del archivo en la barra lateral "GitHub Solicitud de incorporación de cambios".

    Captura de pantalla de la barra lateral "Solicitud de incorporación de cambios de GitHub". Un nombre de archivo está resaltado con un contorno naranja oscuro.

    Esto muestra una vista de diferencias en el editor, con la versión del archivo de la rama base a la izquierda y la nueva versión del archivo, desde la rama principal de la solicitud de incorporación de cambios, a la derecha.

  4. Para agregar un comentario de revisión, haz clic en el + signo situado junto al número de línea del archivo que se muestra en el lado derecho del editor.

    Captura de pantalla de la vista de diferencias. En la versión principal del archivo, en el lado derecho del editor, se resalta el signo más situado junto a una línea.

  5. Escriba el comentario de revisión y, después, haga clic en Start Review.

    Captura de pantalla de un comentario que se agrega, donde pone "Sí, acepto, esto está más claro". El botón "Iniciar revisión" aparece debajo del comentario.

  6. Opcionalmente, puedes sugerir un cambio en el que el autor de la solicitud de cambios pueda hacer clic para confirmar si están de acuerdo con su sugerencia. Para ello, haz clic y mantén presionado el signo + junto a la primera línea en la que quieres sugerir cambios y, después, arrastra el signo + a la última línea en la que quieres sugerir cambios. Luego, haz clic en Hacer una sugerencia en el cuadro de comentario que se muestra.

    Las líneas seleccionadas se copian en el cuadro de comentario, donde podrás editarlas para sugerir un cambio. Puedes agregar un comentario encima de la línea que contiene ```suggestion para explicar el cambio sugerido.

    Haz clic en Agregar comentario para agregar la sugerencia a la solicitud de cambios.

    Captura de pantalla de un cambio sugerido. Los botones "Hacer una sugerencia" y "Agregar comentario" se muestran debajo del cambio sugerido.

  7. Cuando haya terminado de agregar comentarios de revisión, puede agregar un comentario de resumen para la revisión de la solicitud de incorporación de cambios en la barra lateral "GitHub Solicitud de incorporación de cambios". A continuación, puedes hacer clic en Comentar y enviar, o bien hacer clic en la flecha desplegable y seleccionar Aprobar y enviar o Solicitar cambios y Enviar.

    Captura de pantalla de la barra lateral que muestra las opciones desplegables "Comentar y enviar", "Aprobar y enviar" y "Solicitar cambios y enviar".

Para obtener más información sobre cómo revisar una solicitud de incorporación de cambios, consulta Revisar los cambios propuestos en una solicitud de extracción.

Ver comentarios de una revisión en Codespaces

Una vez que haya recibido comentarios sobre una solicitud de incorporación de cambios, puede abrirlo en un espacio de código en el explorador web, o en VS Code, para ver los comentarios de revisión. Desde ahí, puedes responder a los comentarios, agregar reacciones o descartar la revisión.