Opprett GitHub-problemer for produkter med åpen kildekode

Denne artikkelen lærer deg hvordan du oppretter et GitHub-problem for Microsoft Learn-dokumentasjon relatert til åpen kildekode-produkter. Det lærer deg også hvordan du kan lese andre brukeres problemer og enten legge til dine egne kommentarer i dem eller åpne en pull-forespørsel (PR) for å løse dem.

Produktdokumentasjonen vår med åpen kildekode er et kontinuerlig arbeid som pågår. Å motta gode GitHub-problemer fra bidragsytere hjelper oss med å fokusere vår innsats på de høyeste prioriteringene for fellesskapet.

Hvis du vet hvordan du løser et problem, inviterer vi deg selvfølgelig til å gjøre endringene selv, i stedet for å åpne et problem.

Forutsetning

• Opprett en GitHub-konto hvis du ikke har en.

Opprette et problem

1. Gå til artikkelen du vil kommentere.

2. Bla til bunnen av artikkelen, der du ser alternativer for å sende inn tilbakemelding. Velg Åpne et dokumentasjonsproblem for å opprette et nytt problem. Denne tilbakemeldingen er spesifikk for innholdet og spores som et problem i GitHub.

   

   Du kan også velge Gi produkttilbakemelding for å gå til et mål (for eksempel en tilbakemeldingsportal, GitHub, en e-postadresse) der du kan gi tilbakemelding om selve produktet. Denne tilbakemeldingen er uavhengig av innholdet og har ingen relasjon tilbake til den opprinnelige artikkelen.

3. Systemet åpner et nytt problem for deg i GitHub-repositoriet som lagrer innholdet for artikkelen du viser. Legg til en tittel og en beskrivelse. alle andre felt skal fylles ut automatisk. Når du er ferdig, velger du Send inn nytt problem.

   

   Jo mer detaljert du oppgir, jo mer nyttig er problemet. Fortell oss hvilken informasjon du søkte etter, eller søkeordene du brukte for å få tilgang til denne artikkelen. Hvis du ikke kan komme i gang, kan du fortelle oss hvordan du vil begynne å utforske ny teknologi. Du kan også legge til skjermbilder eller filer for å hjelpe oss med å forstå problemet.

Det var det! Problemet er nå lagt til i Problem-køen. Problemer starter samtalen om hva som må gjøres. Innholdsteamet vil svare på disse problemene med ideer om hva vi kan legge til og be om dine meninger.

Kommentere et problem

Du kan kommentere ethvert problem i et repositorium som støtter GitHub-problemer. Du kan også legge til dine egne kommentarer i et problem du har opprettet.

1. Finn problemet du vil kommentere. Gå til GitHub-repositoriet du vil se på problemer for, i nettleseren. Velg Problemer-fanen for å se de åpne problemene for det repositoriet. Hvis repo har mange problemer, kan du bruke filterlinjen til å filtrere etter etikett, forfatter og mer. Du kan også bruke søkefeltet til å se etter bestemte spørringer. Når du finner et problem som appellerer til deg, velger du det for å åpne det.

   Bare åpen kildekode-produkter som bruker tilbakemeldingsopplevelsen med åpen kildekode, godtar GitHub-problemer. Hvis du vil ha mer informasjon og en liste over deltakende repositorier, kan du se Bruke opplevelsen med åpen kildekode.

2. Les problemet og eventuelle kommentarer som allerede er lagt til av andre. Hvis du vil legge til en kommentar, blar du til bunnen av problemet og skriver inn kommentaren i boksen Legg igjen en kommentar . Når du er ferdig, velger du Kommentar.

   

Åpne en pull-forespørsel for å løse problemer

Når du blar gjennom problemer, kan du finne en som du vet hvordan du løser. I så fall er du velkommen til å åpne en PR for å løse problemet. Hvis du vil ha mer informasjon, kan du se Rediger dokumentasjon i nettleseren.

Når du har åpnet en pr for å løse problemet, går du tilbake til problemet og legger til en kommentar som kobler til din PR. Dette hjelper oss med å spore problemet og PR-en sammen. Bruk nummertegnet (#) etterfulgt av PR-nummeret til å koble til pr. Hvis pr-nummeret for eksempel er 4210, skriver du inn #4210 kommentaren din.