Procesamiento de una solicitud de incorporación de cambios

Después de abrir una solicitud de incorporación de cambios (PR), la solicitud de incorporación de cambios se somete a un conjunto de comprobaciones y revisiones para asegurarse de que los cambios propuestos se pueden combinar. Para obtener más información sobre las solicitudes de incorporación de cambios, consulte Aspectos básicos de Git y GitHub.

Validation

Antes de que la PR pueda combinarse en su rama de destino, es posible que tenga que pasar por uno o más procesos de validación de PR. Después de seleccionar Crear solicitud de cambios, GitHub ejecuta las validaciones configuradas para el repositorio. Cuando finaliza el proceso de validación, los resultados aparecen en la PR.

Los procesos de validación varían según el ámbito de los cambios propuestos y las reglas del repositorio de destino. Después de enviar la PR, puede esperar que se produzca una o varias de las siguientes acciones:

• Capacidad de combinación: en primer lugar, se realiza una prueba básica de capacidad de combinación en GitHub para verificar si los cambios propuestos en su rama entran en conflicto con la rama de destino. Si la solicitud de incorporación de cambios indica que no se ha superado la prueba, será necesario reconciliar el contenido que esté causando los conflictos que impiden la combinación para continuar con el proceso.
• Contrato de licencia de colaboración (CLA): como colaborador que no es de Microsoft, si contribuye a un repositorio público, es posible que se le pida que complete un CLA breve la primera vez que envíe una solicitud de incorporación de cambios a ese repositorio. Una vez completado el paso de CLA, se procesará la PR.
• Etiquetado: las etiquetas se aplican automáticamente a la PR para indicar el estado de la PR a medida que pasa por el flujo de trabajo de validación. Por ejemplo, las nuevas PR pueden recibir automáticamente la etiqueta "no combinar", lo que indica que la PR aún no ha completado los pasos de validación, revisión y aprobación.
• Validación y compilación: comprobaciones automatizadas certifican que los cambios pasan las pruebas de validación. Las pruebas de validación pueden generar advertencias o errores, lo que requiere que realice cambios en uno o varios archivos de la PR para que se pueda combinar. Los resultados de las pruebas de validación se agregan como un comentario en la PR para su revisión, y es posible que también se le envíen por correo electrónico.
• Almacenamiento provisional: tras la validación y la compilación, los artículos cambiados se implementan automáticamente en un entorno de ensayo para revisarlos. En los comentarios de solicitud de incorporación de cambios, aparecen direcciones URL de vista previa.
• Combinación automática: La PR se puede combinar automáticamente si supera las pruebas de validación y determinados criterios. En este caso, no es necesario hacer nada más.

Revisión y dirección de comentarios

Una vez completado todo el procesamiento de solicitudes de incorporación de cambios, debe revisar los resultados (por ejemplo, comentarios de solicitudes de incorporación de cambios, resultados de compilación). Determine si necesita realizar más cambios antes de aprobar la combinación. Es posible que tenga que cambiar el contenido por cualquiera de los siguientes motivos:

• Comentarios de PR de los revisores. Si el revisor de una solicitud de incorporación de cambios ya ha revisado la solicitud y ha detectado algunos problemas o cuestiones destacados que deban resolverse antes de la combinación, también puede proporcionar sus comentarios.
• Comentarios de revisores del mismo nivel.
• Correcciones de formato debido a problemas de representación.
• Errores de validación o advertencias.
• Conflictos de combinación.

Si necesita realizar cambios, puede editar el contenido directamente en la solicitud de incorporación de cambios o puede volver a VS Code para realizar los cambios. Cuando haya terminado, confirme los cambios en la rama de trabajo. La solicitud de incorporación de cambios se actualiza automáticamente con los cambios.

Cada vez que agrega una confirmación a la misma rama de trabajo, la confirmación se agrega automáticamente a la solicitud de incorporación de cambios. Con cada confirmación, el sistema de publicación vuelve a ejecutar los procesos de validación y revisión automáticamente.

Automatización de inicio de sesión y comentarios

Cuando haya solucionado todos los comentarios y errores de validación y esté listo para que los cambios se combinen, es el momento de cerrar la solicitud de incorporación de cambios mediante la creación de un nuevo comentario que lea #sign-off. Debe introducir el comentario para combinar los #sign-off cambios. Incluso si se superan todas las revisiones y comprobaciones de validación, usted es responsable de usar este comentario para indicar a los revisores de solicitudes de incorporación de cambios y a los administradores de repositorios que los cambios están listos para la combinación.

Cuando los revisores determinan que la solicitud de incorporación de cambios está libre de problemas y está firmada, los cambios se combinan en la rama predeterminada y la solicitud de incorporación de cambios se cierra.

La automatización de comentarios permite a los usuarios que no tienen permisos de escritura en un repositorio completar una acción de nivel de escritura asignando la etiqueta adecuada a una solicitud de incorporación de cambios. Si trabaja en un repositorio en el que se ha implementado la automatización de comentarios, use los comentarios de hashtag que se muestran en la tabla siguiente para asignar etiquetas, cambiar etiquetas o cerrar una solicitud de incorporación de cambios. Los autores de Microsoft también serán notificados por correo electrónico para su revisión y aprobación cada vez que se propongan cambios en sus artículos.

Comentario de hashtag	¿Qué hace?
#sign-off	Asigna automáticamente la etiqueta lista para combinar para que los revisores del repositorio sepan que la PR está lista para la revisión/combinación. Si no es el autor indicado e intenta aprobar una solicitud de incorporación de cambios en un repositorio público utilizando el comentario #sign-off, la solicitud se actualiza para indicar que solo el autor puede asignar la etiqueta.
#hold-off	Quita la etiqueta lista para combinar en caso de que cambie de opinión o cometa un error. En el repositorio privado, esto asigna la etiqueta do-not-merge.
#please-close	Cierra la PR si decide no combinar los cambios.
#please-open	Vuelve a abrir una PR o un asunto cerrado.

Publicación

Su solicitud de incorporación de cambios debe combinarla un revisor antes de que los cambios se incluyan en la siguiente ronda programada de publicación. Normalmente, las PR se revisan y combinan por orden de envío.

Una vez que se hayan aprobado y combinado las contribuciones, se seleccionan durante el proceso de publicación. En función del equipo que administre el repositorio al que contribuye, los horarios de publicación pueden variar, pero suelen producirse al menos una vez cada día laborable. Es posible que los artículos tarden hasta 45 minutos en aparecer en línea tras publicarlos.

Una vez publicados, los cambios se publican en Microsoft Learn para que otros puedan aprender de ellos.

Pasos siguientes

Eso es todo. Acaba de hacer una contribución al contenido de Microsoft Learn.