Du har kommit till GitHub-lagringsplatsen där källan för den tekniska dokumentationen som publiceras på Azure Documentation Center på http://azure.microsoft.com/documentation finns.
På den här lagringsplatsen finns också anvisningar om hur du bidrar till vår tekniska dokumentation. En lista över artiklarna i guiden för bidragsinlämnare finns i indexet.
Tack för ditt intresse för Azure-dokumentation!
- Sätt att bidra
- Uppförandekod
- Om dina bidrag till Azure-innehåll
- Så här är lagringsplatsen organiserad
- Använda GitHub, Git och den här lagringsplatsen
- Så här använder du Markdown för att formatera ditt ämne
- Feedback, kommentarer och support
- Fler resurser
- Index över alla artiklar i guiden för bidragsinlämnare (öppnas i en ny sida)
Du kan bidra till Azure-dokumentationen på olika sätt:
- Bidra med en forumdiskussion.
- Skriv Disqus-kommentarer längst ned i artiklarna.
- Du kan enkelt bidra med tekniska artiklar i användargränssnittet för GitHub. Du kan antingen hitta artikeln på den här lagringsplatsen eller så kan du söka efter artikeln på http://azure.microsoft.com/documentation och klicka på länken i den artikel som leder till GitHub-källan för artikeln.
- Om du gör omfattande ändringar i en befintlig artikel, lägger till eller ändrar bilder eller bidrar med en ny artikel, måste du duplicera den här lagringsplatsen, installera Git BASH och Markdown Pad samt lära dig vissa git-kommandon.
Det här projektet använder sig av Microsofts uppförandekod för öppen källkod. Läs Vanliga frågor och svar om uppförandekoden eller kontakta opencode@microsoft.com om du har några andra frågor eller kommentarer.
Mindre ändringar eller förtydliganden i dokumentation och kodexempel som du skickar in till den här lagringsplatsen styrs av Användningsvillkoren för Azure-webbplatsen (ToU).
Om du skickar en pull-begäran med nya eller betydande förändringar av dokumentationen och kodexempel, skickar vi en kommentar i GitHub där du uppmanas att skicka ett licensavtal för bidragsinlämnare online (CLA, Contribution License Agreement), om du tillhör någon av dessa grupper:
- Medlemmar av gruppen Microsoft Open Technologies.
- Bidragsinlämnare som inte arbetar för Microsoft.
Du måste fylla i hela online-formuläret innan vi kan acceptera din pull-begäran.
Fullständig information finns på http://azure.github.io/guidelines/#cla.
Innehållet på lagringsplatsen för Azure-innehåll följer samma struktur som dokumentationen på Azure.Microsoft.com. Den här lagringsplatsen innehåller två rotmappar:
Mappen \articles innehåller dokumentationsartiklarna formaterade som Markdown-filer med filtillägget .md.
Artiklar i rotkatalogen publiceras till Azure.Microsoft.com med sökvägen http://azure.microsoft.com/documentation/articles/ {artikelns-namn-utan-md} /.
- Filnamn för artiklar: Se våra riktlinjer för namngivning.
Artiklar som har en egen tjänstemapp publiceras till Azure.Microsoft.com med sökvägen http://azure.microsoft.com/documentation/articles/service-folder/{artikelns-namn-utan-md}/
- Undermappar för media: Mappen \articles innehåller mappen \media där mediefilerna för rotkatalogens artikel finns. Inne i den här mappen finns det undermappar med bilder för varje artikel. Tjänstemapparna innehåller en separat mediemapp för artiklarna i varje enskild tjänstemapp. Mapparna med artikelavbildningar får samma namn som artikelfilen, minus filnamnstillägget .md.
Du kan skapa återanvändbara innehållssektioner som ska ingå i en eller flera artiklar. Se Anpassade tillägg som används i det tekniska innehållet.
Den här mappen innehåller den standardiserade Markdown-mallen, med den grundläggande Markdown-formatering som du behöver för en artikel.
Den här mappen innehåller artiklar som ingår i vår guide för bidragsinlämnare.
Om du vill få mer information om hur du kan bidra, hur du använder GitHub UI för att bidra med små ändringar samt hur du kan duplicera och klona lagringsplatsen för att skicka in större bidrag, kan du gå till Installera och konfigurera verktyg för redigering i GitHub.
Om du installerar Git BASH och väljer att arbeta lokalt, kan du gå till Git-kommandon för att skapa en ny artikel eller uppdatera en befintlig för att få anvisningar om hur du skapar en ny lokal arbetsgren, gör ändringar och skickar tillbaka ändringarna till huvudgrenen.
Vi rekommenderar att du skapar lokala arbetsgrenar som är inriktade på ett specifikt ändringsområde. Varje gren bör begränsas till ett enda koncept eller en enda artikel, både för att effektivisera arbetsflödet och för att minska risken för sammanslagningskonflikter. Följande åtgärder har en lämplig omfattning för en ny gren:
- En ny artikel (och associerade bilder)
- Stavnings- och grammatikändringar i en artikel.
- Tillämpa en enda typ av formatändringar på ett stort antal artiklar (t.ex. en ny sidfot angående upphovsrätten).
Alla artiklar på den här lagringsplatsen använder informativ (flavored) markdown för GitHub. Här följer en lista över resurser.
- Grunderna i Markdown
- Utskrivbara fusklappar för Markdown
- En lista över Markdown-redigerare finns under ämnet verktyg och installation.
Metadata för artiklar tillhandahåller vissa funktioner på webbplatsen azure.microsoft.com, till exempel författarattribut, attribut för bidragsinlämnare, synliga sökvägar, artikelbeskrivningar och SEO-optimeringar samt även rapportering av Microsoft-användning för att utvärdera hur väl innehållet fungerar. Metadata är därför viktiga! Här följer riktlinjer om hur du för in dina metadata på rätt.
Gå till indexet i guiden för bidragsinlämnare för att visa alla hjälpämnen.