Versión del artículo: Enterprise Server 2.17
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 sobre cambios específicos. Después de revisar tantos archivos como quieras, puedes aprobar la solicitud de extracción o solicitar cambios adicionales enviando tu revisión con un comentario 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
- Debajo del nombre de tu repositorio, da clic en Solicitudes de extracción.
- En la lista de solicitudes de extracción, haz clic en la solicitud de extracción que deseas revisar.
- En la solicitud de extracción, da clic en Archivos cambiados.
- 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.
- Teclea tu comentario en el campo de comentario.
- Opcionalmente, para sugerir un cambio específico a la línea ,da clic en, luego edita el texto dentro del bloque de sugerencia.
- 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).
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).
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.
- En la solicitud de extracción, da clic en Archivos cambiados.
- Sobre el código que ha cambiado, da clic en Revisar cambios.
- Teclea un comentario que resuma tu retroalimentación sobre los cambios propuestos.
- Selecciona el tipo de revisión que te gustaría proporcionar:
- 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.
- Da clic en Emitir revisión.
Sugerencias:
- 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.