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

Puedes utilizar GitHub Codespaces en el explorador web o en Visual Studio Code para crear solicitudes de incorporación de cambios, revisarlas y enviar comentarios de revisión.

En este artículo

El uso de un codespace para trabajar en una solicitud de incorporación de cambios proporciona todas las ventajas de GitHub Codespaces. Para más información, consulta Resumen de GitHub Codespaces.

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

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

  • Creación de una solicitud de cambios: el terminal y los comandos de Git o la vista "Control de código fuente" permiten crear solicitudes de incorporación de cambios igual que 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.
  • Revisión de una solicitud de incorporación de cambios: una vez que haya abierto una solicitud de incorporación de cambios en un codespace, puede usar la vista "GitHub Pull Request" (Solicitud de incorporación de cambios de GitHub) para agregar comentarios de revisión y aprobar solicitudes de incorporación de cambios. También puedes usar GitHub Codespaces para ver los comentarios de revisión.

Abrir una solicitud de cambios en Codespaces

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

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

  2. En la lista de solicitudes de cambios, haz clic en aquella que quieras abrir en Codespaces.

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

  4. En la pestaña Codespaces, haz 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 más está resaltado.

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

Revisar una solicitud de cambios en Codespaces

  1. Con el editor predeterminado establecido en Visual Studio Code o Visual Studio Code para Web, abre la solicitud de incorporación de cambios en un codespace, tal como se describe en Abrir una solicitud de cambios en Codespaces anteriormente en este artículo.

  2. En la barra de actividades, haz clic en el icono de solicitud de incorporación de cambios de Git para mostrar la barra lateral "Solicitud de incorporación de cambios de GitHub". 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 abriste una solicitud de incorporación de cambios en un codespace y el icono de solicitud de incorporación de cambios no se muestra en la barra de actividades, asegúrate de que has iniciado sesión en GitHub. Haz clic en el icono GitHub de la barra de actividad y, a continuación, haz 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, haz clic en el nombre del archivo en la barra lateral Solicitud de incorporación de cambios de "GitHub Pull Request".

    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 hayas terminado de agregar nuevos comentarios, puedes agregar un comentario de resumen para tu revisión de la solicitud de incorporación de cambios en la barra lateral "Solicitud de incorporación de cambios de GitHub". 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 los comentarios de una revisión en Codespaces

Una vez que hayas recibido comentarios sobre una solicitud de incorporación de cambios, puedes abrirlos en un codespace en el explorador web, o bien en VS Code para ver los comentarios de revisión. Desde ahí, puedes responder a los comentarios, agregar reacciones o descartar la revisión.