Oversigt over vejledning for Microsoft Docs-bidragydere

Velkommen til docs.microsoft.com (Microsoft Docs) bidragydervejledning!

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:

  • Open-source-lagerplan i det åbne for at få feedback om, hvilke dokumenter der er mest nødvendige.
  • Open-source repos review in the open for at publicere det mest nyttige indhold på vores første version.
  • Opdatering af open source-lagre i det åbne for at gøre det nemmere løbende at forbedre indholdet.

Brugeroplevelsen på Microsoft Docs 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 gennemgå nye emner eller oprette kvalitetsproblemer.

Vigtigt

Alle de lagre, som udgiver indhold på docs.microsoft.com, overholder enten 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 spørgsmål eller kommentarer.

Mindre rettelser eller præciseringer vedrørende dokumentation og kodeeksempler på offentlige lagre er underlagt vilkårene for anvendelse af docs.microsoft.com. Nye eller væsentlige ændringer genererer en kommentar i den eksterne pr, hvor du bliver bedt om at indsende en onlinebidragslicensaftale (CLA), hvis du ikke er Microsoft-medarbejder. Vi har brug for, at du udfylder onlineformularen, før vi kan gennemse eller acceptere din pr.

Hurtig redigering 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 pr 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), føres du til kildefilen på GitHub.

    Location of the edit article link.

    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.

    Location of the fork and edit pencil icon.

  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:

    Propose and commit file changes.

  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 "pull-anmodning" (PR). Når du vælger Foreslå ændringer, vises der en ny side, der ligner følgende:

    Compare changes and create pull request.

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

  6. Det var det! Medlemmer af indholdsteamet gennemser din pr 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 for bidragydere, der ikke har skriverettigheder til destinationslageret. GitHub opretter automatisk en kopi af mållageret på din konto. Det nyoprettede forgreningsnavn har som standard formularen GitHubUsername/RepositoryName . Hvis du har skriveadgang til destinationslageret, f.eks. din gaffel, opretter GitHub en ny forgrening i destinationslageret. Forgreningsnavnet har standardformularen patch -n ved hjælp af et numerisk id for programrettelsesforgreningen.

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

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 PR-kø. 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. Se på et af vores Docs-lagre, og kontrollér de åbne PR'er 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 Docs. De forklarer, hvordan du arbejder med GitHub lagre, Markdown-værktøjer og udvidelser, der bruges i Microsoft Docs-platformen.