Introducción a la edición de documentación en Microsoft Learn

Gracias por su interés en editar la documentación sobre Microsoft Learn. Sus contribuciones nos ayudan a garantizar que nuestra documentación esté bien escrita y actualizada, y sea precisa. La información de esta página le ayudará a decidir qué método de colaboración es mejor para usted.

Requisito previo

Antes de empezar, asegúrese de haber iniciado sesión en su cuenta de GitHub. Si no tiene una cuenta en GitHub, acceda a https://github.com/join para poder registrarse de forma rápida y gratuita.

Cambios menores en la documentación

Los cambios menores son rápidos y fáciles. Algunos ejemplos de cambios menores:

• Corrección de erratas
• Revisión de un único artículo
• Adición de una sección a un artículo
• Corrección de un error
• Actualización de vínculos rotos

Si va a realizar cambios menores, solo necesita una cuenta de GitHub.

Para realizar un cambio menor, seleccione el icono de lápiz Editar este documento en la parte superior del artículo. Esta acción le lleva al archivo de origen en GitHub, donde puede realizar los cambios. Cuando haya terminado, se le pedirá que cree una solicitud de incorporación de cambios (PR) para proponer los cambios. Para ver un tutorial completo de este proceso, consulte Edición de documentación en el explorador.

Cambios importantes en la documentación

Los cambios importantes implican más tiempo y esfuerzo. Algunos ejemplos de cambios importantes:

• Cambios complejos que le llevarán varios días
• Revisiones de varios artículos que desea enviar juntos
• Creación de un nuevo artículo
• Contribución frecuente

Si va a realizar cambios importantes, debe descargar e instalar algunas herramientas para facilitar el trabajo. Siga estos pasos para comenzar:

1. Instale las herramientas de Git y Markdown.
2. Configure un repositorio de Git local.
3. Realización de cambios en la documentación.
4. Creación de una PR.

Información general del proceso

El flujo de proceso que figura a continuación muestra los pasos generales que hay que dar para empezar a realizar cambios menores e importantes. Tenga en cuenta que algunos elementos son pasos únicos, mientras que otros tienen lugar cada vez que inicia una nueva colaboración.

La imagen comienza con un punto de decisión en el que se le pregunta si esta es la primera vez que contribuye. Si es así, el siguiente paso es configurar la cuenta de GitHub. Si no, el siguiente paso es otro punto de decisión en el que debe plantearse si el cambio que va a realizar es menor. Si es así, el siguiente paso es la edición en el explorador. Si no, los pasos siguientes serán instalar herramientas de creación, bifurcar y clonar el repositorio, realizar los cambios, abrir una solicitud de incorporación de cambios y revisar y aprobar la solicitud de incorporación de cambios.

Cambios en los módulos de entrenamiento

Los colaboradores no pueden editar ni proponer cambios en los módulos de entrenamiento. En este momento, solo la documentación de Microsoft Learn almacenada en repositorios públicos está abierta para las contribuciones públicas.