Revisar los cambios propuestos en una solicitud de extracción

Descripción del propósito de la solicitud de incorporación de cambios

Obtener una comprensión clara de la motivación detrás de una solicitud de incorporación de cambios ayuda a orientar su revisión, por lo que pueda mantenerla dirigida y significativa, y proporcionar comentarios que se alineen con la intención del autor de la solicitud de incorporación de cambios y los objetivos del proyecto.

Hay varias opciones disponibles para comprender mejor el contexto y la justificación de los cambios propuestos.

Uso de la barra lateral del pull request para el contexto

En la barra lateral del pull request, puede encontrar un contexto valioso, que incluye:

• Problemas vinculados o discusiones: revise estos temas para comprender los problemas o objetivos que la solicitud de extracción pretende abordar, o para recopilar información sobre, por ejemplo, cualquier antecedente, decisiones de diseño o debates actuales.

•         **Proyectos** o **hitos vinculados**: revise cómo encaja este pull request dentro de proyectos más amplios o lanzamientos futuros.
  

Use esta información para enmarcar la revisión y comprobar si los objetivos de la solicitud de incorporación de cambios se alinean con la intención original.

Comenzar una revisión

1. En el nombre del repositorio, haz clic en Pull requests.

   

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.

   
   Puede cambiar el formato de la vista de diferencias en esta pestaña si hace clic en y elige la vista unificada o dividida. La opción que elijas se aplicará cuando veas el diff para otros pull requests.
   

   También puede 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 que muestren solo aquellos que quieras revisar o utiliza el árbol de archivos para navegar a uno específico. Para más información, consulta Filtrar archivos en una petición de incorporación de cambios.

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.

   

6. Opcionalmente, puede agregar un comentario en varias líneas. Para seleccionar un intervalo de líneas, haga clic en el número de línea de la primera línea en la que desea comentar y, a continuación, arrastre hacia abajo hasta la línea final o mantenga presionada la tecla Mayús y haga clic en el último número de línea. A continuación, puede hacer clic en el icono de comentario azul de la última línea en la que desea comentar. Como alternativa, puede hacer clic en el icono de comentario azul situado junto a la primera línea sobre la que desea comentar y, a continuación, arrastrarla hacia abajo hasta la última línea sobre la que desea comentar.

7. Teclea tu comentario en el campo de comentario.

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

   

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

   

10. 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 en línea están pendientes y solo usted puede verlos. Puede editar los comentarios pendientes en cualquier momento antes de enviarstu 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.](/assets/images/help/pull_requests/abandon-review-button.png)

Revisar los cambios de las dependencias

Si el pull request contiene cambios en las dependencias, puede utilizar la revisión de dependencias para un archivo de bloqueo o de manifiesto para ver qué ha cambiado y verificar si los cambios introduzcan vulnerabilidades de seguridad. Para más información, consulta Revisar los cambios en las dependencias en un pull request.

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

   

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.

   

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 .

   

Marcar un archivo como visto

Después de que haya terminado de revisar un archivo, puede 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.

   

2. A la derecha del encabezado del archivo que ha terminado de revisar, seleccione 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 incorporación de cambios, haz clic en Archivos cambiados.

   

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

   

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.