Ejercicio: Contribuir a un artículo de documentación de Microsoft Learn

  • 4 minutos

Practiquemos el flujo de trabajo de contribución. En este ejercicio, realizarás un pequeño cambio en un artículo de documentación de código abierto en Microsoft Learn. A continuación, propondrás los cambios abriendo una solicitud de cambios.

Edición del artículo

  1. Inicie sesión en su cuenta de GitHub.

  2. En una pestaña del explorador, ve a learn.microsoft.com/contribute/content.

  3. En la parte superior del artículo, seleccione el icono de lápiz Editar.

    Captura de pantalla del artículo Contribuir abierto y el icono de Edición de lápiz resaltado.

  4. Seleccione el icono lápiz para Bifurcar este repositorio y editar en la bifurcación o Editar este archivo en la bifurcación de este proyecto.

    Captura de pantalla del archivo de código fuente del artículo de Contribución abierto en un explorador y el icono Editar resaltado.

  5. Si GitHub le solicita que bifurque el repositorio en la siguiente página, seleccione Bifurcar el repositorio.

  6. Se abre el panel Editar archivo. Debe agregar una nueva frase al principio de este artículo. Al principio del segundo párrafo, agregue lasiguiente frase: Microsoft Learn hospeda toda la documentación de productos y tecnologías de Microsoft.

    Captura de pantalla del archivo Contribuir editado con una nueva frase y el botón Confirmar cambios resaltado.

Apertura de una solicitud de incorporación de cambios

  1. Puede obtener la vista previa de los cambios seleccionando la pestaña Vista previa.

  2. Una vez finalizados los cambios, busque y seleccione Confirmar cambios.

  3. En el campo Mensaje de confirmación, escriba "TEST contribution".

    Captura de pantalla del campo Mensaje de confirmación rellenado con contribución TEST.

  4. Seleccione Proponer cambios.

  5. En la página Comparar cambios, compruebe que la base indica main. Esto significa que los cambios se extraerán en la rama principal del repositorio activo.

    Captura de pantalla de la página para comprobar que la base es Principal, lo que significa que los cambios se combinarán en la rama principal.

    Nota:

    Si no ve las opciones base repository y head repository en esta página, seleccione comparar entre bifurcación. Esto muestra las opciones de comparación necesarias para este paso.

  6. Seleccione el botón Crear solicitud de cambios.

  7. Esto le lleva a la página Abrir una solicitud de cambios, donde puede obtener una vista previa de su PR.

  8. Confirme su PR y seleccione Crear una solicitud de cambios para abrir el PR.

    Captura de pantalla de la solicitud de incorporación de cambios abierta.

Nota:

Dado que se trata de un ejercicio de práctica, los cambios no se combinarán en el sitio web activo.

¡Felicitaciones por la creación de su PR! Aún no se ha enviado, pero ha terminado el primer paso importante para contribuir. Deje la pestaña de PR abierta en el explorador. Volverás a ella en el próximo ejercicio.