Gids voor inzenders van Microsoft Docs: overzicht

Welkom bij de gids voor Microsoft Docs inzenders!

Als u uw expertise deelt met anderen op Microsoft Learn, kan iedereen meer bereiken. Gebruik de informatie in deze handleiding om een nieuw artikel te publiceren naar Microsoft Learn of om updates aan te brengen in een bestaand gepubliceerd artikel.

Door uw expertise te delen met anderen op Learn, kan iedereen meer bereiken. Gebruik de informatie in deze handleiding om een nieuw artikel te publiceren naar learn.microsoft.com of updates aan te brengen in een artikel dat al is gepubliceerd.

Meerdere Microsoft-documentatiesets zijn open source en worden gehost op GitHub. Niet alle documentensets zijn volledig open source, maar veel hebben openbare opslagplaatsen waar u wijzigingen kunt voorstellen via pull-aanvragen (PR). Deze opensource-benadering stroomlijnt en verbetert de communicatie tussen producttechnici, inhoudsteams en klanten, en heeft andere voordelen:

  • Opensource-opslagplaatsen plannen in het open gebied om feedback te krijgen over de documenten die het meest nodig zijn.
  • Beoordeling van opensource-opslagplaatsen in de open versie om de nuttigste inhoud te publiceren in onze eerste release.
  • Opensource-opslagplaatsen worden bijgewerkt in het geopende bestand om het gemakkelijker te maken om de inhoud continu te verbeteren.

De gebruikerservaring op Microsoft Learn integreert GitHub-werkstromen rechtstreeks om het nog eenvoudiger te maken. Begin met het bewerken van het document dat u bekijkt. Of help door nieuwe onderwerpen te bekijken of kwaliteitsproblemen te maken.

Belangrijk

Alle opslagplaatsen die naar Microsoft Learn publiceren, hebben de Microsoft Open Source-gedragscode of de .NET Foundation-gedragscode aangenomen. Zie Veelgestelde vragen over de gedragscode voor meer informatie. Neem contact op opencode@microsoft.com met of conduct@dotnetfoundation.org met eventuele vragen of opmerkingen.

Kleine correcties of verduidelijkingen in documentatie en codevoorbeelden in openbare opslagplaatsen vallen onder de learn.microsoft.com Gebruiksvoorwaarden. Nieuwe of significante wijzigingen genereren een opmerking in de pull-aanvraag, waarin u wordt gevraagd om een online cla (Contribution License Agreement) in te dienen als u geen Microsoft-werknemer bent. U moet het onlineformulier invullen voordat we uw pull-aanvraag kunnen bekijken of accepteren.

Snelle bewerkingen in documentatie

Snelle bewerkingen stroomlijnen het proces om kleine fouten en weglatingen in documentatie te rapporteren en op te lossen. Ondanks alle moeite kunnen er toch kleine grammatica- en spelfouten in onze gepubliceerde documenten opduiken. Hoewel u problemen kunt maken om fouten te rapporteren, is het sneller en eenvoudiger om een pull-aanvraag te maken om het probleem op te lossen, wanneer de optie beschikbaar is.

  1. Op sommige documentatiepagina's kunt u rechtstreeks in de browser inhoud bewerken. Als dat het geval is, wordt de knop Bewerken weergegeven. Zie het voorbeeld hieronder. Als u de knop Bewerken (of equivalent gelokaliseerd) kiest, gaat u naar het bronbestand op GitHub.

    Locatie van de koppeling naar het bewerkingsartikel.

    Als de knop Bewerken niet aanwezig is, betekent dit dat de inhoud niet is geopend voor openbare bijdragen. Sommige pagina's worden gegenereerd (bijvoorbeeld uit inlinedocumentatie in code) en moeten worden bewerkt in het project waartoe ze behoren.

  2. Selecteer het potloodpictogram om het artikel te bewerken. Als het potloodpictogram grijs wordt weergegeven, moet u zich bij uw GitHub-account aanmelden of een nieuw account maken.

    Locatie van het vork- en potloodpictogram bewerken.

  3. Bewerk het bestand in de webeditor. Kies het tabblad Voorbeeld om de opmaak van uw wijzigingen te controleren.

  4. Wanneer u klaar bent met bewerken, schuift u naar de onderkant van de pagina. Voer in het gebied Wijzigingen voorstellen een titel en desgewenst een beschrijving voor uw wijzigingen in. De titel is de eerste regel van het doorvoerbericht. Selecteer Wijzigingen voorstellen om uw wijzigingen door te voeren:

    Bestandswijzigingen voorstellen en doorvoeren.

  5. Nu u uw wijzigingen hebt voorgesteld en doorgevoerd, moet u de eigenaren van de opslagplaats vragen om uw wijzigingen in hun opslagplaats op te halen. Dit gebeurt met behulp van een zogenaamde pull-aanvraag (PR). Wanneer u Wijzigingen voorstellen selecteert, wordt een nieuwe pagina weergegeven die er ongeveer als volgt uitziet:

    Vergelijk wijzigingen en maak een pull-aanvraag.

    Selecteer Pull-aanvraag maken. Voer vervolgens een titel en een beschrijving voor de pull-aanvraag in en selecteer vervolgens Pull-aanvraag maken. Als u geen kennis hebt met GitHub, raadpleegt u Over pull-aanvragen voor meer informatie.

  6. Dat is alles. Leden van het inhoudsteam beoordelen uw pull-aanvraag en voegen deze samen wanneer deze is goedgekeurd. Mogelijk krijgt u feedback over het aanvragen van wijzigingen.

De gebruikersinterface voor GitHub-bewerkingen reageert op uw machtigingen voor de opslagplaats. De voorgaande installatiekopie├źn zijn bedoeld voor inzenders die geen schrijfmachtigingen hebben voor de doelopslagplaats. In GitHub wordt automatisch een fork van de doelopslagplaats gemaakt in uw account. De zojuist gemaakte forknaam heeft standaard het formulier GitHubUsername/RepositoryName . Als u schrijftoegang hebt tot de doelopslagplaats, zoals uw fork, maakt GitHub een nieuwe vertakking in de doelopslagplaats. De naam van de vertakking heeft de standaardformulierpatch,n met behulp van een numerieke id voor de patchvertakking.

We gebruiken PULL's voor alle wijzigingen, zelfs voor inzenders die schrijftoegang hebben. De meeste opslagplaatsen beveiligen de standaardbranch, zodat updates moeten worden verzonden als PULL-aanvragen.

Voor kleinere of incidentele wijzigingen kunt u het beste de bewerkingservaring binnen browsers gebruiken. Als u grote bijdragen levert of geavanceerde Git-functies gebruikt (zoals vertakkingsbeheer of geavanceerde oplossingen voor samenvoegingsconflicten), moet u de opslagplaats splitsen en lokaal werken.

Notitie

De meeste gelokaliseerde documentatie biedt niet de mogelijkheid om feedback te bewerken of te geven via GitHub. Als u feedback wilt geven over gelokaliseerde inhoud, gebruikt u de e-mailsjabloon die beschikbaar is op aka.ms/DocSiteLocFeedback.

Openstaande PR's controleren

U kunt nieuwe onderwerpen lezen voordat ze worden gepubliceerd door de openstaande pull-aanvraagwachtrij te controleren. Bij controles wordt het proces van de GitHub-workflow gevolgd. U kunt voorgestelde updates of nieuwe artikelen in openbare opslagplaatsen bekijken. Controleer deze en voeg uw opmerkingen toe. Bekijk een van onze Microsoft Learn-opslagplaatsen en controleer de open PULL's voor gebieden die u interesseren. Feedback uit de community over voorgestelde updates is nuttig voor de gehele community.

Kwaliteitsproblemen maken

Onze documentatie wordt doorlopend aangevuld en verbeterd. Dankzij goede probleemmeldingen kunnen we onze inspanningen richten op de hoogste prioriteiten van de community. Hoe gedetailleerder deze zijn, des te nuttiger is de probleemmelding. Vertel ons naar welke informatie u op zoek was. Vertel ons welke zoektermen u hebt gebruikt. Vertel ons, als u niet aan de slag kunt, hoe u wilt beginnen met het verkennen van onbekende technologie.

Veel van de documentatiepagina's van Microsoft hebben een feedbacksectie onder aan de pagina waar u ervoor kunt kiezen om productfeedback of inhoudsfeedback te laten staan om problemen bij te houden die specifiek zijn voor dat artikel.

Probleemmeldingen zijn het startpunt om te bespreken wat er nodig is. Het inhoudsteam reageert op deze probleemmeldingen met idee├źn over wat we kunnen toevoegen, en vraagt om uw mening. Wanneer we een concept maken, vragen we u om de PR te beoordelen.

Meer betrokken raken

Andere onderwerpen in deze handleiding helpen u productief te bijdragen aan Microsoft Learn. Ze leggen uit hoe u werkt met GitHub-opslagplaatsen, Markdown-hulpprogramma's en extensies die worden gebruikt in de Microsoft Learn-inhoud.