Revisar solicitudes de incorporación de cambios
Azure Repos | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018-TFS 2015
Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015
Después de crear una solicitud de extracción, envíe la solicitud de solicitud de cambio para su revisión por parte de las partes interesadas. Puede agregar revisores obligatorios u opcionales a la pr. Los revisores necesarios deben aprobar la solicitud de solicitud para poder combinarla.
Teams también puede establecer directivas de rama que requieren un número mínimo de revisores, o determinados revisores obligatorios u opcionales, antes de que determinados clientes de las ramas protegidas puedan combinarse. Puede cambiar los revisores incluidos opcionales para que los requieran o quitarlos, pero no puede quitar los revisores necesarios para la directiva de rama. Para obtener más información sobre cómo establecer directivas de rama y revisores, vea Incluir automáticamente revisores de código.
Las revisiones de alta calidad comienzan con comentarios de alta calidad. Para obtener instrucciones sobre cómo obtener y proporcionar comentarios de revisión, consulte Comentarios de solicitud de extracción.
Requisitos previos
Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a Repos.
Para revisar los PR, debe ser miembro del proyecto de Azure DevOps en el que se encuentra la PR, con acceso Básico o superior. Si no es miembro del proyecto, obtenga agregado.
Nota
En el caso de los proyectos públicos, los usuarios a los que se concede acceso de las partes interesadas tienen acceso total a Azure Repos.
Repos debe estar habilitado en el proyecto. Si el Repos y las páginas asociadas no se muestran, consulte Activar o desactivar un servicio de Azure DevOps para volver a Repos.
Para revisar las PR, debe ser miembro del proyecto Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
- Para ver o revisar las PR, debe ser miembro del proyecto Azure DevOps con acceso básico o superior. Si no es miembro del proyecto, obtenga agregado.
- Para más información sobre los permisos y el acceso, consulte Permisos predeterminados de repositorio y rama de Git y Acerca de los niveles de acceso.
- En Azure DevOps Server 2020 y Azure DevOps Services, puede administrar LOS Y otros recursos desde la interfaz de la línea de comandos (CLI) de Azure con la extensión . Para obtener información sobre cómo trabajar con la CLI Azure DevOps Services, consulte Introducción a la CLI Azure DevOps . Azure Repos comandos de la CLI para pr usan az repos pr.
Examinar cambios
Para obtener una imagen rápida del estado de la PR, en la pestaña Información general de la PR se resumen las comprobaciones, los requisitos y las directivas de rama que la PR está pasando o con errores. En algunos casos, el resumen muestra un fragmento de código del mensaje de error del registro de una comprobación de estado. En la información general solo se enumeran las directivas con errores, pero puede ver todas las comprobaciones de directiva superada y con errores seleccionando Ver n > comprobaciones.
En la pestaña Información general de la PR, puede revisar la descripción de la pr. y los comentarios para comprender los cambios propuestos y ver los problemas que otros revisores han producido.
Revisión de archivos
Seleccione la pestaña Archivos de PR para revisar los cambios reales realizados en la rama de origen, en línea o en paralelo con la rama de destino.
Para ver el aspecto de los archivos markdown publicados, seleccione el botón Ver de un archivo y, a continuación, seleccione Vista previa.
Nota
Al ver la diferencia de un único archivo seleccionado,hay un límite de tamaño de archivo de 5 MB. Para ver y diferenciar archivos de más de 5 MB, puede descargar el archivo y verlo mediante una herramienta de diferencias local. Al ver la diferencia de una colección de archivos, el límite de tamaño de cada archivo es de 0,5 MB, por motivos de rendimiento.
Seleccione la pestaña Archivos de solicitud de cambios para ver los cambios reales realizados en la rama de origen junto a la rama de destino de la solicitud de extracción.
Nota
Al ver la diferencia de un único archivo seleccionado,hay un límite de tamaño de archivo de 5 MB. Para ver y diferenciar archivos de más de 5 MB, puede descargar el archivo y verlo mediante una herramienta de diferencias local. Al ver la diferencia de una colección de archivos, el límite de tamaño de cada archivo es de 0,5 MB, por motivos de rendimiento.
Revisión de actualizaciones
Puede revisar las versiones anteriores del código en la lista desplegable Todos los cambios. Cada actualización de la rama agrega una nueva versión a la lista y en la pestaña Actualizaciones de la pr. A medida que selecciona actualizaciones diferentes, la vista de diferencias se actualiza para mostrar las diferencias entre los archivos de cada versión de la pr.
Puede ponerse al día con las actualizaciones de pr. después de estar fuera de la pr., para lo que debe seguir los cambios realizados desde la última revisión. Puede ver varias actualizaciones a la vez presionando Mayús mientras selecciona las actualizaciones que desea ver.
Revise las versiones anteriores del código en la lista desplegable Todas las actualizaciones.
Cada actualización de la rama agrega una nueva versión a la lista y en la pestaña Actualizaciones de la pr. A medida que selecciona actualizaciones diferentes, la vista de diferencias se actualiza para mostrar las diferencias entre los archivos de cada versión de la pr.
Puede ponerse al día con las actualizaciones de pr. después de estar fuera de la pr., para lo que debe seguir los cambios realizados desde la última revisión.
Examine una lista de cambios del autor en la pestaña Actualizaciones.
Vea y seleccione los cambios realizados en confirmaciones en la rama en la pestaña Confirmaciones.
Examine una lista de cambios del autor en la pestaña Actualizaciones.
Vea y seleccione los cambios realizados en confirmaciones en la rama en la pestaña Confirmaciones.
Realizar comentarios
Agregue comentarios a una solicitud de inserción de cambios para realizar sugerencias, responder a comentarios anteriores y señalar problemas con los cambios propuestos.
Comente en línea en la pestaña Archivos de una pr., para lo que debe mantener el puntero sobre la línea en la que desea comentar y seleccionar el botón comentario
.
Comente en línea en la pestaña Archivos de una pr. para lo que debe mantener el puntero sobre la línea en la que desea comentar y seleccionar el botón Comentario botón Comentario en una
Para enviar comentarios no vinculados a una línea de código específica, haga comentarios en la pestaña Información general.
Direccione al autor u otros revisores directamente en sus comentarios mediante y haga referencia
@usernamea elementos de trabajo mediante#workitemID. También puede hacer referencia a otras PR mediante!pullrequestID.
Sugerir cambios
Para sugerir cambios directamente, seleccione el icono de bombilla en la interfaz de comentario, realice los cambios sugeridos en el código y, a continuación, seleccione Comentario.
Edición, eliminación o me gusta un comentario
Para editar o eliminar un comentario que hizo, mantenga el puntero sobre el comentario y seleccione el icono de lápiz para editar el comentario, o bien el icono de cubo de elementos no utilizados para eliminar el comentario.
Para que le guste el comentario propio o de otra persona, mantenga el puntero sobre el comentario y seleccione el icono de flecha arriba. Los comentarios con me gusta muestran un icono rellenado y el número de "me gusta" en la lista de comentarios. Mantenga el puntero sobre el icono para ver la lista de personas que le gustaron el comentario.
Like a comment (Me gusta un comentario)
Para que le guste un comentario que usted u otra persona haya realizado, seleccione el icono de corazón. Mantenga el puntero sobre el icono en comentarios para ver la lista de personas que le gustaron el comentario.
Filtrar comentarios
Puede seleccionar qué comentarios y actualizaciones se muestran en la página Información general. Ocultar algunos comentarios y actualizaciones hace que se desasoyen al revisar el código por primera vez. También puede mostrar solo las novedades desde la última vez que visitó la pr.
Para filtrar comentarios y actualizaciones, seleccione el botón Mostrar todo (n) situado encima de la lista de comentarios y seleccione una de las opciones de filtrado. La vista cambia para mostrar solo los comentarios y actualizaciones seleccionados. La etiqueta del botón cambia para mostrar los criterios de filtrado y el número de elementos mostrados.
Votación de los cambios
Use el botón situado en la esquina superior derecha de la pr. para votar los cambios de la pr. La opción predeterminada es Aprobar,pero puede seleccionar otras opciones en la lista desplegable:
- Aprobar:apruebe los cambios propuestos en la solicitud de cambio.
- Aprobar con sugerencias:apruebe la solicitud de solicitud de acceso, pero proporcione sugerencias opcionales para la mejora.
- Espere al autor:no apruebe los cambios y pida al autor que revise los comentarios. El autor debe permitir que vuelva a revisar el código después de abordar sus preocupaciones.
- Rechazar:los cambios no son aceptables. Deje un comentario en la pr para explicar por qué.
- Restablecer comentarios:quite el voto.
Restablecer comentarios
Para quitar el voto de una solicitud de solicitud de acceso, seleccione Restablecer comentarios en la lista desplegable Aprobar en la esquina superior derecha de la solicitud de solicitud de acceso.
Comentarios de direcciones
Para realizar actualizaciones rápidas de la solicitud de cambio en respuesta a los comentarios, seleccione Editar en la página Archivos de la rama en la web.
Después de actualizar los archivos, confirme los cambios e inste las actualizaciones a la pr.
También puede aplicar inmediatamente los cambios sugeridos por los revisores seleccionando Aplicar cambio en el comentario en la página Información general de la solicitud de cambio. Una vez que haya aplicado todos los cambios que desee, seleccione Confirmar todos los cambios.
Puede realizar actualizaciones rápidas en la rama directamente desde la pestaña Archivosde Código en la web.
Respuesta y resolución de comentarios
Responda a los comentarios y actualice el estado de los comentarios para que los revisores sepan cómo aborda sus comentarios y sugerencias.
- Para resolver un comentario sin responder, seleccione Resolver en el comentario.
- Para responder al comentario, escriba la respuesta en el campo Escribir una respuesta y seleccione Responder.
- Para responder y resolver el comentario, escriba la respuesta en el campo Escribir una respuesta y seleccione Responder resolver.
- Responda a revisores específicos mediante en la respuesta y haga
@usernamereferencia a elementos de trabajo mediante#workitemID. También puede hacer referencia a otras PR mediante!pullrequestID.
Los nuevos comentarios comienzan en Estado activo. Seleccione Resolver o Resolver para actualizar el estado del comentario a Resuelto.
Hay más opciones disponibles en la lista desplegable de resolución de comentarios:
- Activo:el comentario todavía está en revisión.
- Pendiente:el problema de este comentario se solucionará, pero aún no se ha corregido.
- Resuelto:se ha corregido el problema que se ha presentado en este comentario.
- No se corregirá:se indica la sugerencia del comentario, pero esta PR no lo abordará.
- Cerrado:se cierra la discusión de este comentario.
Para realizar un seguimiento de los archivos que ya se han revisado, seleccione Más opciones junto a un archivo en la pr. y, a continuación, seleccione Marcar como revisado.