Overzicht van bewerkingsdocumentatie op Microsoft Learn
Bedankt voor uw interesse in het bewerken van documentatie over Microsoft Learn. Uw bijdragen helpen ons ervoor te zorgen dat onze documentatie goed geschreven, up-to-date en nauwkeurig is. De informatie op deze pagina helpt u te bepalen welke methode van bijdrage het beste voor u is.
Vereiste
Controleer voordat u begint of u bent aangemeld bij uw GitHub-account. Als u geen GitHub-account hebt, gaat u naar https://github.com/join een snelle en gratis registratieprocedure.
Kleine wijzigingen in documentatie
Kleine wijzigingen zijn snel en eenvoudig. Voorbeelden van kleine wijzigingen zijn:
- Typfouten corrigeren
- Eén artikel reviseren
- Een sectie toevoegen aan een artikel
- Een fout corrigeren
- Verbroken koppelingen bijwerken
Als u kleine wijzigingen aanbrengt, hebt u alleen een GitHub-account nodig.
Als u een kleine wijziging wilt aanbrengen, selecteert u het potloodpictogram Dit document bewerken boven aan het artikel. Met deze actie gaat u naar het bronbestand op GitHub, waar u uw wijzigingen kunt aanbrengen. Wanneer u klaar bent, wordt u gevraagd om een pull-aanvraag (PR) te maken om uw wijzigingen voor te stellen. Zie de documentatie bewerken in de browser voor een volledig overzicht van dit proces.
Belangrijke wijzigingen in documentatie
Belangrijke wijzigingen hebben meer tijd en moeite met zich mee. Voorbeelden van belangrijke wijzigingen zijn:
- Complexe wijzigingen die u enkele dagen in beslag nemen
- Revisies naar meerdere artikelen die u samen wilt indienen
- Een nieuw artikel maken
- Vaak bijdragen
Als u belangrijke wijzigingen aanbrengt, moet u enkele hulpprogramma's downloaden en installeren om uw werk gemakkelijker te maken. Volg deze stappen om aan de slag te gaan:
- Installeer Git- en Markdown-hulpprogramma's.
- Een lokale Git-opslagplaats instellen.
- Breng wijzigingen aan in de documentatie.
- Maak een pull-aanvraag.
Procesoverzicht
In de onderstaande processtroom ziet u de stappen op hoog niveau die nodig zijn om aan de slag te gaan voor kleine en grote wijzigingen. U ziet dat sommige items eenmalige stappen zijn, terwijl andere items elke keer optreden wanneer u een nieuwe bijdrage start.
De afbeelding begint met een beslissingspunt van Is dit uw eerste bijdrage? Zo ja, dan is de volgende stap het instellen van uw GitHub-account. Zo nee, dan is de volgende stap een ander beslissingspunt van Is uw wijziging secundair? Zo ja, dan is de volgende stap het bewerken in de browser. Zo nee, de volgende stappen omvatten het installeren van ontwerphulpprogramma's, het splitsen en klonen van de opslagplaats, het aanbrengen van wijzigingen, het openen van een pull-aanvraag en het controleren en ondertekenen van uw pull-aanvraag.
Wijzigingen in trainingsmodules
Inzenders kunnen geen wijzigingen in trainingsmodules bewerken of voorstellen. Op dit moment is alleen microsoft Learn-documentatie die is opgeslagen in openbare opslagplaatsen geopend voor openbare bijdragen.