Oversigt over redigering af dokumentation på Microsoft Learn
Tak for din interesse i at redigere dokumentation på Microsoft Learn! Dine bidrag hjælper os med at sikre, at vores dokumentation er velskrevet, opdateret og nøjagtig. Oplysningerne på denne side hjælper dig med at beslutte, hvilken metode der er bedst for dig.
Forudsætning
Før du starter, skal du sørge for, at du er logget på din GitHub-konto. Hvis du ikke har en GitHub-konto, kan du gå til for at https://github.com/join få en hurtig og gratis tilmeldingsproces.
Mindre ændringer i dokumentationen
Mindre ændringer er hurtige og nemme. Eksempler på mindre ændringer omfatter:
- Retter stavefejl
- Revision af en enkelt artikel
- Tilføjelse af en sektion til en artikel
- Rettelse af en fejl
- Opdaterer brudte kæder
Hvis du foretager mindre ændringer, skal du kun bruge en GitHub-konto!
Hvis du vil foretage en mindre ændring, skal du vælge blyantsikonet Rediger dette dokument øverst i artiklen. Denne handling fører dig til kildefilen på GitHub, hvor du kan foretage dine ændringer. Når du er færdig, bliver du bedt om at oprette en pullanmodning for at foreslå dine ændringer. Du kan få en komplet gennemgang af denne proces i Rediger dokumentation i browseren.
Større ændringer i dokumentationen
Større ændringer kræver mere tid og kræfter. Eksempler på større ændringer omfatter:
- Komplekse ændringer, der vil tage dig flere dage at fuldføre
- Ændringer af flere artikler, som du vil sende sammen
- Oprettelse af en ny artikel
- Bidrager ofte
Hvis du foretager større ændringer, skal du downloade og installere et par værktøjer for at gøre dit arbejde nemmere. Kom i gang ved at følge disse trin:
- Installér Git- og Markdown-værktøjer.
- Konfigurer et lokalt Git-lager.
- Foretag ændringer i dokumentationen.
- Opret en pullanmodning.
Procesoversigt
Procesforløbet nedenfor viser de trin på højt niveau, der er involveret i at komme i gang med mindre og større ændringer. Bemærk, at nogle elementer er engangstrin, mens andre forekommer, hver gang du starter et nyt bidrag.
Billedet starter med et beslutningspunkt i Er det første gang, du bidrager? Hvis ja, er det næste trin at konfigurere din GitHub-konto. Hvis nej, er næste trin et andet beslutningspunkt: Er ændringen mindre? Hvis ja, er det næste trin at redigere i browseren. Hvis nej, omfatter de næste trin installation af oprettelsesværktøjer, kopiering og kloning af lageret, ændring, åbning af en pullanmodning og gennemsyn og signering på din pullanmodning.
Ændringer i træningsmoduler
Bidragydere kan ikke redigere eller foreslå ændringer af træningsmoduler. På nuværende tidspunkt er det kun Microsoft Learn-dokumentation, der er gemt i offentlige lagre, der er åben for offentlige bidrag.