Revisar los cambios propuestos en una solicitud de extracción

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

Acerca de revisar las 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.

Tip: Puedes encontrar una solicitud de extracción en donde se te haya solicitado una revisión, ya sea a ti o a algún equipo del que seas miembro, con el calificador de búsqueda review-requested:[USERNAME] o team-review-requested:[TEAMNAME]. Para obtener más información, consulta la sección "Buscar informes de problemas y solicitudes de extracción".

Comenzar una revisión

  1. Debajo del nombre de tu repositorio, da clic en Solicitudes de cambios.
    ![Selección de la pestaña de propuestas y solicitudes de extracción](/assets/images/help/repository/repo-tabs-pull-requests.png)
    
  2. En la lista de solicitudes de extracción, haz clic en la solicitud de extracción que deseas revisar.
  3. En la solicitud de cambios, haz clic en Archivos cambiados.

Pull Request Files changed tab

  1. Pasa el puntero sobre la línea de código en la que deseas agregar un comentario y da clic en el icono de comentario azul. Para agregar un comentario en líneas múltiples, da clic y arrastra para seleccionar el rango de líneas, luego da clic en el icono de comentario azul. Icono de comentario azul
  2. Teclea tu comentario en el campo de comentario. Campo de comentario
  3. Opcionalmente, para sugerir un cambio específico a la línea o líneas,da clic en, luego edita el texto dentro del bloque de sugerencia. Bloque de sugerencia
  4. Cuando estés listo, haz clic en Start a review (Comenzar una revisión). Si ya comenzaste una revisión, puedes hacer clic en Add review comment (Agregar comentario de revisión). Botón Start a review (Comenzar una revisión)

Antes de enviar tu revisión, tus comentarios de líneas quedan pendientes, y solo tú los puedes ver. 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, desplázate hasta el final de la cronología en la pestaña Conversation (Conversación) y haz clic en Cancel review (Cancelar revisión).

Botón Cancel review (Cancelar revisión)

Puedes utilizar los Codespaces para probar, ejecutar y revisar las solicitudes de cambios.

  1. Abre la solicitud de cambios en un codespace, de acuerdo con lo descrito en "Abrir una solicitud de cambios".
  2. En la barra de actividad, haz clic en la vista de Solicitud de cambios de GitHub. Esta vista solo se muestra cuando abres una solicitud de cambios en un codespace. Opción para abrir una solicitud de cambios en un codespace
  3. Para revisar un archivo específico, haz clic en el icono de Abrir archivo en la barra lateral. Opción para abrir una solicitud de cambios en un codespace
  4. Para agregar comentarios, haz clic en el icono de + junto al número de línea. Teclea tu comentario de revisión y luego haz clic en Comenzar revisión. Opción para abrir una solicitud de cambios en un codespace
  5. Cuando termines de revisar los comentarios, desde la barra lateral, puedes elegir ya sea emitirlos, aprobar los cambios, o solicitar cambios. Opción para abrir una solicitud de cambios en un codespace

Para obtener más información sobre revisar las solicitudes de cambios en los Codespaces, consulta la sección "Utilizar los Codespaces para las solicitudes 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, consulta la sección "Revisar los cambios a las dependencias en una solicitud de cambios".

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

Pull Request Files changed tab

  1. A la derecha del encabezado de un archivo de bloqueo o de manifiesto, muestra la revisión de dependencias dando clic en el botón de diff enriquecido .

    El botón de diff rica

  2. 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 diff orígen, da clic en el botón .

    El botón de diff origen

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 cambios, haz clic en Archivos cambiados.

Pull Request Files changed tab 2. A la derecha del encabezado del archivo que terminaste de revisar, selecciona Viewed (Visto). Casilla Viewed (Visto)

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 cambios, haz clic en Archivos cambiados.

Pull Request Files changed tab

  1. Sobre el código que ha cambiado, da clic en Revisar cambios. Botón para revisar cambios
  2. Teclea un comentario que resuma tu retroalimentación sobre los cambios propuestos. Ventana de comentarios para el resumen de la revisión
  3. Selecciona el tipo de revisión que te gustaría proporcionar: Botones Radio con opciones de revisión
    • Selecciona Comment (Comentario) para dejar una opinión general sin aprobar de manera explícita los cambios ni solicitar cambios adicionales.
    • Selecciona Approve (Aprobar) para enviar tus comentarios y aprobar la fusión de los cambios propuestos en la solicitud de extracción.
    • Selecciona Request changes (Solicitar cambios) para enviar comentarios que se deban tener en cuenta antes de que se pueda fusionar la solicitud de extracción.
  4. Da clic en Emitir revisión.

Tips:

  • Si se habilita las revisiones requeridas y un colaborador con acceso de write, admin, u owner emite una revisión solicitando cambios, la solicitud de extracción no se podrá fusionar hasta queel mismo colaborador emita otra revisión aprobando los cambios en dicha solicitud de extracción.
  • 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.

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.