GitHub-ongelmien luominen avoimen lähdekoodin tuotteille

Tässä artikkelissa opetetaan, miten voit luoda Avoimen lähdekoodin tuotteisiin liittyvän Microsoft Learn -dokumentaation GitHub-ongelman. Siinä kerrotaan myös, miten voit tutkia muiden käyttäjien ongelmia ja lisätä niihin omia kommenttejasi tai avata pull-pyynnön (PR), jos haluat käsitellä niitä.

Avoimen lähdekoodin tuotedokumentaatiomme työstää jatkuvasti. Hyvien GitHub-ongelmien vastaanottaminen osallistujilta auttaa meitä keskittymään yhteisön tärkeimpiin prioriteetteihin.

Jos osaat korjata ongelman, kutsumme sinut tietysti tekemään muutokset itse ongelman avaamisen sijaan.

Muistiinpano

GitHub-ongelmat hyväksytään vain avoimen lähdekoodin palautetta hyödyntämällä. Lisätietoja ja luettelo osallistuvista säilöistä on kohdassa Avoimen lähdekoodin käyttökokemuksen käyttäminen. Jos haluat lisätietoja siitä, miten voit antaa muuta kuin GitHub-palautetta Microsoft Learn -ympäristössä, katso Palautetta Microsoft Learnista.

Edellytykset

• Luo GitHub-tili, jos sinulla ei ole sellaista.

Ongelman luominen

1. Siirry artikkeliin, jota haluat kommentoida.

2. Vieritä artikkelin alareunaan, jossa näet vaihtoehdot palautteen lähettämiselle. Luo uusi ongelma valitsemalla Avaa dokumentaatio-ongelma . Tämä palaute koskee sisältöä, ja sitä seurataan ongelmana GitHubissa.

   

   Vaihtoehtoisesti voit valita Anna palautetta tuotteesta siirtyäksesi kohdesijaintiin (esimerkiksi palauteportaali, GitHub, sähköpostiosoite), jossa voit antaa palautetta itse tuotteesta. Tämä palaute on sisällöstä riippumaton eikä sillä ole suhdetta takaisin alkuperäiseen artikkeliin.

3. Järjestelmä avaa sinulle uuden ongelman GitHub-säilössä, joka tallentaa tarkastelemiesi artikkelien sisällön. Lisää otsikko ja kuvaus. kaikkien muiden kenttien tulee täyttyä automaattisesti. Kun olet valmis, valitse Lähetä uusi ongelma.

   

   Mitä enemmän tietoja annat, sitä hyödyllisempi ongelma on. Kerro meille, mitä tietoja hait tai mitä hakutermejä käytit päästäksesi tähän artikkeliin. Jos et pääse alkuun, kerro meille miten haluaisit aloittaa vieraaseen tekniikkaan tutustumisen. Voit myös lisätä näyttökuvia tai tiedostoja, jotka auttavat meitä ymmärtämään ongelmasi.

Siinä kaikki! Ongelmasi lisätään nyt Ongelmat-jonoon. Ongelmista ilmoittaminen synnyttää keskustelua tarvittavista toimista. Sisältötiimi voi reagoida ongelmiin ideoilla siitä, mitä voimme lisätä ja kysyä mielipiteitäsi.

Kommentoi aihetta

Voit kommentoida mitä tahansa aihetta säilössä, joka tukee GitHub-ongelmia. Voit myös lisätä omia kommenttejasi luomaasi ongelmaan.

1. Etsi aihe, jota haluat kommentoida. Siirry selaimessa GitHub-säilöön, jossa haluat tutkia ongelmia. Valitse Ongelmat-välilehti, jos haluat tarkastella säilön avoimia ongelmia. Jos säilössä on paljon ongelmia, suodata selitteen, tekijän ja muiden asioiden mukaan Suodattimet-palkin avulla. Voit myös etsiä tiettyjä kyselyitä hakupalkin avulla. Kun löydät ongelman, joka vetoaa sinuun, valitse se avataksesi sen.

   GitHub-ongelmat hyväksytään vain avoimen lähdekoodin palautetta hyödyntämällä. Lisätietoja ja luettelo osallistuvista säilöistä on kohdassa Avoimen lähdekoodin käyttökokemuksen käyttäminen.

2. Lue ongelma ja mahdolliset kommentit, jotka muut ovat jo lisänneet. Jos haluat lisätä kommentin, siirry ongelman loppuun ja kirjoita kommenttisi Jätä kommentti -ruutuun. Kun olet valmis, valitse Kommentoi.

   

Ongelmien korjaaminen avaamalla pull-pyyntö

Kun selaat ongelmia, saatat löytää ongelman, jonka tiedät korjattavan. Jos näin on, voit avata pr:n ongelman ratkaisemiseksi. Jos haluat lisätietoja, katso Dokumentaation muokkaaminen selaimessa.

Kun olet avannut ongelman ratkaisemiseksi pr:n, palaa ongelmaan ja lisää kommentti, joka linkittää pull-pyyntöön. Tämä auttaa seuraamaan ongelmaa ja pull-pyyntöä yhdessä. Käytä ristikkomerkkiä (#) ja sitten PR-numeroa pull-pyyntöön linkittämiseksi. Jos pull-pyyntösi numero on esimerkiksi 4210, voit kirjoittaa #4210 siihen kommentin.