Oversigt over vejledning for Microsoft Docs-bidragydere

Velkommen til vejledningen til Microsoft Docs bidragydere!

Deling af din ekspertise med andre i Microsoft Learn hjælper alle med at opnå mere. Brug oplysningerne i denne vejledning til at publicere en ny artikel til Microsoft Learn eller foretage opdateringer af en eksisterende publiceret artikel.

Deling af din ekspertise med andre i Learn hjælper alle med at opnå mere. Brug oplysningerne i denne vejledning til at publicere en ny artikel for at learn.microsoft.com eller foretage opdateringer af en artikel, der allerede er publiceret.

Flere af Microsofts dokumentationssæt er i åben kildekode og er hostet på GitHub. Ikke alle dokumentsæt er helt åben kildekode, men mange har offentlige lagre, hvor du kan foreslå ændringer via pullanmodninger. Denne tilgang med åben kildekode strømliner og forbedrer kommunikationen mellem produktteknikere, indholdsteams og kunder, og den har andre fordele:

  • Lagre med åben kildekode planlægger i det åbne for at få feedback om, hvilke dokumenter der er mest brug for.
  • Lagre med åben kildekode gennemses i det åbne for at publicere det mest nyttige indhold i vores første version.
  • Lagre med åben kildekode opdateres i det åbne for at gøre det nemmere løbende at forbedre indholdet.

Brugeroplevelsen på Microsoft Learn integrerer GitHub-arbejdsprocesser direkte for at gøre det endnu nemmere. Start med at redigere det dokument, du får vist. Eller hjælp ved at gennemse nye emner eller oprette kvalitetsproblemer.

Vigtigt

Alle lagre, der publicerer til Microsoft Learn, har vedtaget Ordensreglerne for Microsoft Open Source eller ordensreglerne for .NET Foundation. Se Ofte stillede spørgsmål om ordensregler for at få flere oplysninger. Kontakt opencode@microsoft.com eller conduct@dotnetfoundation.org med eventuelle spørgsmål eller kommentarer.

Mindre rettelser eller præciseringer af dokumentation og kodeeksempler i offentlige lagre er omfattet af learn.microsoft.com Vilkår for anvendelse. Nye eller væsentlige ændringer genererer en kommentar i pullanmodningen, hvor du bliver bedt om at indsende en CLA-aftale (Contribution License Agreement), hvis du ikke er Microsoft-medarbejder. Vi har brug for, at du udfylder onlineformularen, før vi kan gennemse eller acceptere din pullanmodning.

Hurtige redigeringer af dokumentation

Hurtige redigeringer strømliner processen for at rapportere og rette små fejl og udeladelser i dokumentationen. Til trods for alle anstrengelser sniger der sig mindre grammatiske fejl og stavefejl ind i de publicerede dokumenter. Selvom du kan oprette problemer for at rapportere fejl, er det hurtigere og nemmere at oprette en pullanmodning for at løse problemet, når indstillingen er tilgængelig.

  1. nogle dokumentationssider kan du redigere indhold direkte i browseren. I disse tilfælde kan du se en knap af typen Rediger i stil med den, der er vist nedenfor. Hvis du vælger knappen Rediger (eller tilsvarende lokaliseret), kommer du til kildefilen på GitHub.

    Placering af linket til redigering af artikel.

    Hvis knappen Rediger ikke findes, betyder det, at indholdet ikke er åbent for offentlige bidrag. Nogle sider genereres (f.eks. fra indbygget dokumentation i kode) og skal redigeres i det projekt, de tilhører.

  2. Vælg blyantsikonet for at redigere artiklen. Hvis blyantikonet er nedtonet, skal du enten logge på din GitHub-konto eller oprette en ny konto.

    Placering af kopien, og rediger blyantikonet.

  3. Rediger filen i webeditoren. Vælg fanen Eksempel for at kontrollere formateringen af dine ændringer.

  4. Når du er færdig med at redigere, skal du rulle til bunden af siden. I området Foreslå ændringer skal du angive en titel og eventuelt en beskrivelse af dine ændringer. Titlen er den første linje i bekræftelsesmeddelelsen. Vælg Foreslå ændringer for at bekræfte dine ændringer:

    Foreslå og udfør filændringer.

  5. Nu, hvor du har foreslået og bekræftet dine ændringer, skal du bede ejerne af lageret om at "trække" dine ændringer ind i deres lager. Dette gøres ved hjælp af noget, der kaldes en "pullanmodning". Når du vælger Foreslå ændringer, vises der en ny side, der ligner følgende:

    Sammenlign ændringer, og opret en pullanmodning.

    Vælg Opret pullanmodning. Derefter skal du angive en titel og en beskrivelse af pullanmodningen og derefter vælge Opret pullanmodning. Hvis du ikke kender GitHub, skal du se Om pullanmodninger for at få flere oplysninger.

  6. Det var det! Medlemmer af indholdsteamet gennemser din pullanmodning og fletter den, når den godkendes. Du kan få feedback, der anmoder om ændringer.

Brugergrænsefladen til redigering i GitHub ændrer sig i forhold til dine tilladelser i lageret. De foregående billeder er til bidragydere, der ikke har skriverettigheder til mållageret. GitHub opretter automatisk en kopi af mållageret på din konto. Det nyoprettede kopinavn har som standard formularen GitHubUsername/RepositoryName . Hvis du har skriveadgang til mållageret, f.eks. din kopi, opretter GitHub en ny forgrening i mållageret. Forgreningsnavnet har standardformularen patch- ved hjælp af en numerisk identifikator for patch-forgreningenn.

Vi bruger pullanmodninger til alle ændringer, selv for bidragydere, der har skriveadgang. De fleste lagre beskytter standardforgreningen, så opdateringer skal sendes som pullanmodninger.

Det er bedst kun at bruge redigeringsfunktionen i browseren til mindre eller sjældne ændringer. Hvis du vil foretage store ændringer eller bruge avancerede Git-funktioner, f.eks. administration af forgreninger eller avanceret løsning af fletningskonflikter, skal du kopiere lageret og arbejde lokalt.

Bemærk

Den mest lokaliserede dokumentation giver ikke mulighed for at redigere eller give feedback via GitHub. Hvis du vil give feedback om lokaliseret indhold, skal du bruge den mailskabelon, der er tilgængelig på aka.ms/DocSiteLocFeedback.

Korrekturlæs åbne pullanmodninger

Du kan læse nye emner, før de publiceres, ved at kontrollere den åbne kø for pullanmodninger. Al korrektur følger GitHub-flowprocessen. Du kan se de opdateringer, der er blevet foreslået, eller de nye artikler, der findes i de offentlige lagre. Korrekturlæs dem, og tilføj dine kommentarer. Kig på et af vores Microsoft Learn-lagre, og kontrollér de åbne pullanmodninger for områder, der interesserer dig. Feedback fra community'et til foreslåede opdateringer hjælper alle i community'et.

Rapportér kvalitetsproblemer

Vi arbejder hele tiden på vores dokumenter. Rapportering af kvalitetsproblemer hjælper os med at fokusere vores arbejde på de dokumenter, der har førsteprioritet for community'et. Jo flere oplysninger du kan give os, jo bedre. Fortæl os, hvilke oplysninger du søgte efter. Fortæl os, hvilke søgeord du brugte. Hvis du ikke kan komme i gang, så fortæl os, hvordan du vil begynde med at udforske ukendt teknologi.

Mange af Microsofts dokumentationssider har et feedbackafsnit nederst på siden, hvor du kan vælge at efterlade produktfeedback eller indholdsfeedback for at spore problemer, der er specifikke for den pågældende artikel.

Problemer sætter gang i samtalen om, hvad der er brug for. Indholdsgruppen vil besvare problemerne med idéer til, hvad vi kan tilføje, og de vil bede om din mening. Når vi opretter en kladde, beder vi dig om at korrekturlæse pullanmodningen.

Vil du bidrage mere?

Andre emner i denne vejledning hjælper dig med at komme i gang med at bidrage produktivt til Microsoft Learn. De forklarer, hvordan du arbejder med GitHub-lagre, Markdown-værktøjer og udvidelser, der bruges i Microsoft Learn-indholdet.