Skip to main content

Revisar los cambios propuestos en una solicitud de extracción

En una solicitud de incorporación de cambios, puedes revisar y opinar sobre las confirmaciones, los archivos cambiados y las diferencias (o "diff") entre los archivos de las ramas base y comparada.

Tool navigation

Acerca de revisar solicitudes de extracción

Puedes revisar los cambios de una solicitud de extracción en un archivo por vez. Mientras revisas los archivos en una solicitud de extracción, puedes dejar comentarios individuales en cambios específicos. Después de que terminas de revisar cada archivo, puedes marcarlo como visto. Esto colapsa el archivo, lo cual te ayuda a identificar los archivos que aún debes revisar. Una barra de progreso en el encabezado de la solicitud de cambios muestra la cantidad de archivos que has visto. Después de revisar tantos archivos como quieras, puedes aprobar la solicitud de cambios o solicitar cambios adicionales si emites tu revisión con un comentario de resumen.

Propina: Puedes encontrar una solicitud de incorporación de cambios en la que se te solicite a ti o a un equipo del que formes parte una revisión con el calificador de búsqueda review-requested:[USERNAME] o team-review-requested:[TEAMNAME]. Para obtener más información, vea «Buscar propuestas y solicitudes de extracción».

Comenzar una revisión

  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 incorporación de cambios, haga clic en la que quiera revisar.

  3. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro. Puedes cambiar el formato de la vista de diferencias en esta pestaña si haces clic en y eliges la vista unificada o dividida. La elección que hagas aplicará cuando veas el diff para otras solicitudes de cambio.

    Captura de pantalla de la pestaña "Archivos cambiados" de una solicitud de incorporación de cambios. La pestaña "Vista de diferencias" está resaltada en naranja oscuro.

    También puedes elegir esconder las diferencias de espacios en blanco. La elección que hagas solo aplicará a esta solicitud de cambios y se recordará la siguiente ocasión que visites la página.

  4. Opcionalmente, filtra los archivos para mostrar solo aquellos que quieras revisar o utiliza el árbol de archivos para ir a uno en concreto. Para obtener más información, vea «Filtrar archivos en una solicitud de extracción».

  5. Mantén el puntero sobre la línea de código donde quieres agregar un comentario y haz clic en el icono de comentario azul. Para agregar un comentario en varias líneas, haz clic y arrastra para seleccionar el intervalo de líneas y, luego, haz clic en el icono de comentario azul.

    Captura de pantalla de un diferencia en una solicitud de incorporación de cambios. Junto a un número de línea, se resalta un icono de signo más de color azul con un contorno naranja.

  6. Teclea tu comentario en el campo de comentario.

  7. Opcionalmente, para sugerir un cambio específico en una o varias líneas, haz clic en y, luego, edita el texto dentro del bloque de sugerencias.

    Captura de pantalla de un cuadro de comentario de revisión. El icono de diferencia de archivo para sugerir un cambio específico está resaltado en naranja oscuro.

  8. Para comentar directamente un archivo, a la derecha de este, haz clic en y escribe el comentario.

    Captura de pantalla de un archivo de imagen en la página "Archivos cambiados" de una solicitud de incorporación de cambios. A la derecha del archivo de imagen, un icono de comentario está resaltado en naranja.

  9. Cuando haya terminado, haga clic en Iniciar una revisión. Si ya ha iniciado una revisión, puede hacer clic en Agregar comentario de revisión.

Antes de enviar la revisión, los comentarios de líneas están pendientes y solo los puede ver usted. Puedes editar los comentarios pendientes en cualquier momento antes de enviar tu revisión. Para cancelar una revisión pendiente, incluidos todos sus comentarios pendientes, haz clic en Revisar cambios encima del código modificado y, luego, haz clic en Cancelar revisión.

Captura de pantalla del campo de comentarios de una revisión. El botón "Cancelar revisión" está resaltado en naranja oscuro.

Puedes usar GitHub Codespaces para probar, ejecutar y revisar las solicitudes de incorporación de cambios.

  1. Abre la solicitud de incorporación de cambios en un codespace, tal como se describe en "Uso de GitHub Codespaces para las solicitudes de incorporación de cambios".

  2. En la barra de actividad, haga clic en la vista GitHub Pull Request. Esta vista solo se muestra cuando abres una solicitud 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".

  3. Para revisar un archivo específico, haga clic en el icono Open File en la barra lateral.

    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.

  4. Para agregar comentarios de revisión, haga clic en el icono + situado junto al número de línea. 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.

  5. 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.

  6. Cuando termines de revisar los comentarios, desde la barra lateral, puedes elegir ya sea emitirlos, aprobar los cambios, o solicitar cambios.

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

Para más información sobre cómo revisar solicitudes de incorporación de cambios en GitHub Codespaces, consulta "Uso de GitHub Codespaces para las solicitudes de incorporación de cambios".

Revisar los cambios de las dependencias

Si la solicitud de cambios contiene cambios para las dependencias, puedes utilizar la revisión de dependencias para un archivo de bloqueo o de manifiesto para ver qué ha cambiado y verificar si los cambios introducen vulnerabilidades de seguridad. Para obtener más información, vea «Revisar los cambios de las dependencias en una solicitud de cambios».

  1. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro.

  2. A la derecha del encabezado de un archivo de bloqueo o de manifiesto, haga clic en el botón de diferencias enriquecidas para mostrar la revisión de dependencias.

    Captura de pantalla de la pestaña "Archivos cambiados" de una solicitud de incorporación de cambios. El botón para mostrar la diferencia enriquecida, etiquetada con un icono de archivo, está resaltado en naranja oscuro.

  3. Puede que también quieras revisar el diff origen, ya que podría haber cambios en el archivo de bloqueo o de manifiesto que no cambian de dependencia o podrían haber dependencias que GitHub no puede procesar, las cuales, como resultado, no aparecen en la revisión de dependencias.

    Para regresar a la vista de diferencias de origen, haz clic en el botón .

    Captura de pantalla de la pestaña "Archivos cambiados" de una solicitud de incorporación de cambios. El botón para mostrar las diferencias de origen, que está etiquetada con un icono de código, está resaltado en naranja oscuro.

Marcar un archivo como visto

Después de que hayas terminado de revisar un archivo, puedes marcar el archivo como visto, y el archivo se colapsará. Si el archivo se modifica después de que lo hayas visto, dejará de estar marcado como visto.

  1. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro.

  2. A la derecha del encabezado del archivo que ha terminado de revisar, seleccione Visto.

    Captura de pantalla del encabezado de un archivo. La opción "Visto" está resaltada en naranja oscuro.

Enviar tu revisión

Después de que hayas terminado de revisar todos los archivos que quieras de la solicitud de extracción, envía tu revisión.

  1. En la solicitud de incorporación de cambios, haz clic en Archivos cambiados.

    Captura de pantalla de las pestañas de una solicitud de incorporación de cambios. La pestaña "Archivos cambiados" está resaltada en naranja oscuro.

  2. Encima del código cambiado, haga clic en Revisar cambios.

    Captura de pantalla de la pestaña "Archivos cambiados" de una solicitud de incorporación de cambios. El botón "Revisar cambios" está resaltado en naranja oscuro.

  3. Teclea un comentario que resuma tu retroalimentación sobre los cambios propuestos.

  4. Selecciona el tipo de revisión que te gustaría proporcionar:

    • Seleccione Comentario para dejar un comentario general sin aprobar de manera explícita los cambios ni solicitar cambios adicionales.
    • Seleccione Aprobar para enviar los comentarios y aprobar la combinación de los cambios propuestos en la solicitud de incorporación de cambios.
    • Seleccione Solicitar cambios para enviar comentarios que se deben abordar antes de que se pueda combinar la solicitud de incorporación de cambios.
  5. Haga clic en Enviar revisión.

Sugerencias:

  • Si un colaborador con acceso de admin, owner o write al repositorio envía una revisión de solicitud de cambios, la solicitud de incorporación de cambios no se puede combinar hasta que el mismo colaborador envíe otra revisión en la que se aprueben las modificaciones en la solicitud de incorporación de cambios.
  • Los propietarios y administradores del repositorio pueden fusionar una solicitud de extracción, incluso si no recibió una revisión de aprobación o si un revisor que solicitó modificaciones abandonó la organización o no está disponible.
  • Si están habilitadas las revisiones requeridas y el descarte de una revisión en espera, y se sube una confirmación de modificación de código a la rama de una solicitud de extracción aprobada, se descarta la aprobación. La solicitud de extracción se debe volver a revisar y aprobar antes de que se pueda fusionar.
  • Cuando varias solicitudes de extracción abiertas tienen una rama de encabezado que apunta a la misma confirmación, no podrás fusionarlas si una o ambas tienen una revisión pendiente o rechazada.
  • Si tu repositorio requiere revisiones de aprobación de personas con permisos de escritura o administrativos, entonces cualquier aprobación de las personas con dichos permisos se denotará con una marca de verificación verde y las aprobaciones de las personas sin estos permisos tendrán una marca de verificación gris. Las aprobaciones con una marca de verificación gris no afectan la capacidad de la solicitud de cambios para fusionarse.
  • Los autores de la solicitud de cambios no pueden aprobar sus propias solicitudes de cambios.

Información adicional