Op dit project is de Microsoft Open Source Code of Conduct (Microsoft Open Source-gedragscode) van toepassing. Zie voor meer informatie de Code van Conduct FAQ of neem contact op met [email protected] met aanvullende vragen of opmerkingen.
Bijdragen vanuit de community (gebruikers, klanten, partners, MSFT-werknemers buiten core Azure-producteenheden, enz.) en vanuit werknemers in core Azure-producteenheden zijn van harte welkom. Op welke manier u kunt bijdragen, hangt af van wie u bent:
-
Community - minder ingrijpende updates: Als u kleine wijzigingen wilt toepassen, kunt u het artikel vinden in deze opslagplaats of het artikel bezoeken op https://docs.microsoft.com/azure. Als u klikt op de koppeling Bewerken in het artikel, wordt u naar de GitHub-bron van het artikel geleid. Vervolgens kunt u aan de hand van de GitHub-UI uw updates toepassen. U bent ook van harte welkom om de opslagplaats te forken en via uw fork de updates te verzenden.
-
Community - nieuwe artikelen: Als u deel uitmaakt van de Azure-community en u wilt een nieuw artikel maken, moet u werken met een werknemer zodat het nieuwe artikel via een combinatie van privéopslagplaatsen en openbare opslagplaatsen kan worden aangemaakt.
-
Werknemers: Wanneer u een technisch schrijver, programmamanager of ontwikkelaar van het productteam voor een Azure-service bent en het is uw taak om bij te dragen aan technische artikelen of deze te schrijven, moet u de privéopslagplaats gebruiken op (https://github.com/MicrosoftDocs/azure-docs-pr). Als u grotere veranderingen aanbrengt aan een bestaand artikel, afbeeldingen toevoegt of wijzigt of een nieuw artikel aanlevert, zult u de opslagplaats moeten forken, Git Bash installeren, een Markdown-editor installeren en Git--opdrachten moeten kennen. Zie handleiding voor de interne bijdragers voor meer informatie.
Kleine correcties of verduidelijkingen die u indient voor documentatie en codevoorbeelden in deze opslagplaats vallen onder de docs.microsoft.com-gebruiksvoorwaarden.
Als u een nieuwe of belangrijke wijziging in de documentatie of aan de code-voorbeelden en een pull-aanvraag indient, sturen we u een opmerking in GitHub waarin we u vragen een CLA (Contribution License Agreement) in te dienen als u geen medewerker van Microsoft bent. U moet het online-formulier invullen voordat we uw pull-aanvraag kunnen accepteren.
Community-gebruikers kunnen de GitHub UI of de repository forken om bij te dragen. Werknemers zullen de handleiding voor de interne bijdragers moeten bezoeken voor meer informatie over hoe u kunt bijdragen aan de technische documentatie.
De inhoud in de opslagplaats azure-docs volgt de documentatiestructuur op https://docs.microsoft.com/azure. Deze bibliotheek bevat twee hoofdmappen:
De map \articles bevat de documentatieartikelen die zijn opgemaakt als Markdown-bestanden met de indeling .md. Artikelen zijn doorgaans gegroepeerd op Azure-service.
De \articles map bevat de \media voor mediabestanden voor de hoofdmap-artikelen. Daarbinnen staan submappen met de afbeeldingen voor elk artikel. De servicemappen bevatten een afzonderlijke mediamap voor de artikelen in elke servicemap. De mappen met afbeeldingen voor de artikelen hebben dezelfde naam als het artikelbestand, maar zonder de bestandsextensie .md.
U kunt herbruikbare secties met content maken die moeten worden opgenomen in een of meer artikelen.
Alle artikelen in deze bibliotheek gebruiken GitHub-Markdown. Hier volgt een lijst van resources.
In de openbare opslagplaats azure-docs worden automatisch labels toegevoegd aan pull-aanvragen om ons te helpen de workflows voor pull-aanvragen te beheren en u te laten weten wat de status is van uw pull-aanvraag:
- Met betrekking tot de CLA
- cla-not-required: De wijziging is relatief klein en vereist geen CLA.
- cla-required: Het bereik van de verandering is relatief groot en vereist dat een CLA wordt ondertekend.
- cla-signed: De bijdrager heeft de CLA ondertekend, zodat de pull-aanvraag kan worden doorgezet voor een review.
- Change sent to author: De auteur is ingelicht over de openstaande pull-aanvraag.
- ready-to-merge: Klaar om te worden bekeken door ons beoordelingsteam voor pull-aanvragen.