Vytváranie problémov v GitHube pre open-source produkty

V tomto článku sa naučíte, ako vytvoriť problém v službe GitHub pre dokumentáciu služby Microsoft Learn súvisiacu s open-source produktmi. Naučí vás tiež, ako vnímať problémy iných používateľov a pridávať k nim vlastné komentáre alebo otvoriť žiadosť o prijatie zmien na ich riešenie.

Naša open-source dokumentácia k produktom neustále napreduje. Získanie dobrých problémov v GitHube od prispievateľov nám pomáha sústrediť naše úsilie na najvyššie priority pre komunitu.

Ak viete, ako problém vyriešiť, samozrejme, pozývame vás na vykonanie zmien namiesto toho, aby ste otvorili problém.

Poznámka

Iba open-source produkty používajúci prostredie na odosielanie pripomienok typu open-source akceptujú problémy v službe GitHub. Ďalšie informácie a zoznam zúčastnených odkladacích priestorov nájdete v téme Použitie prostredia typu open-source. Ďalšie informácie o tom, ako poskytnúť pripomienky mimo služby GitHub prostredníctvom platformy Microsoft Learn, nájdete v téme Poskytnutie pripomienok k platforme Microsoft Learn.

Požiadavky

• Ak ho nemáte, vytvorte si konto v službe GitHub.

Vytvorenie problému

1. Prejdite na článok, ku ktorému chcete pridať komentár.

2. Prejdite do dolnej časti článku, kde nájdete možnosti odoslania pripomienok. Vyberte položku Otvoriť problém s dokumentáciou a vytvorte nový problém. Tieto pripomienky sa týkajú konkrétneho obsahu a v GitHube sa sledujú ako problém.

   

   Môžete tiež vybrať možnosť Zadať pripomienky k produktu a prejsť do cieľa (napríklad na portál na pripomienky, GitHub, e-mailovú adresu), kde môžete poskytnúť pripomienky k samotnému produktu. Táto spätná väzba je nezávislá od obsahu a nemá žiadny vzťah späť k pôvodnému článku.

3. Systém vám otvorí v odkladacom priestore GitHub nový problém, ktorý uchováva obsah článku, ktorý si prezeráte. Pridajte názov a popis. Všetky ostatné polia by sa mali vyplniť automaticky. Po dokončení vyberte položku Odoslať nový problém.

   

   Čím viac detailov poskytnete, tým viac nám pomôže tento problém. Povedzte nám, aké informácie ste hľadali alebo hľadané výrazy, ktoré ste použili na získanie informácií k tomuto článku. Ak sa vám nedarí začať, povedzte nám, ako plánujete skúmať nové technológie. Môžete tiež pridať snímky obrazovky alebo súbory, ktoré nám pomôžu pochopiť váš problém.

To je všetko! Váš problém sa teraz pridá do frontu Problémy. Vďaka problémom sa môžeme rozprávať o tom, čo je skutočne potrebné. Obsahový tím na tieto problémy zareaguje nápadmi na to, čo môžeme pridať, a požiadať o vaše názory.

Komentovať problém

Akékoľvek problémy môžete komentovať v odkladacom priestore, ktorý podporuje problémy v službe GitHub. K problému, ktorý ste vytvorili, môžete pridať aj vlastné komentáre.

1. Vyhľadajte problém, ku ktorému chcete pridať komentár. V prehliadači prejdite do odkladacieho priestoru GitHub, v ktorom chcete riešiť problémy. Vyberte kartu Problémy, na ktorej sa zobrazia otvorené problémy pre daný odkladací priestor. Ak odkladací priestor obsahuje veľa problémov, pomocou panela Filtre môžete filtrovať podľa označenia, autora a ďalších možností. Prípadne môžete pomocou panela hľadania vyhľadať konkrétne dotazy. Keď nájdete problém, ktorý vás apeluje, vyberte ho a otvorte ho.

   Iba open-source produkty používajúci prostredie na odosielanie pripomienok typu open-source akceptujú problémy v službe GitHub. Ďalšie informácie a zoznam zúčastnených odkladacích priestorov nájdete v téme Použitie prostredia typu open-source.

2. Prečítajte si problém a všetky komentáre, ktoré už pridali ostatní. Ak chcete pridať komentár, posuňte sa do dolnej časti problému a zadajte komentár do poľa Zanechať komentár . Po dokončení vyberte položku Komentár.

   

Otvorenie žiadosti o prijatie zmien na riešenie problémov

Pri prehľadávaní môžete nájsť problém, ktorý viete vyriešiť. Ak áno, víta vás otvorenie žiadosti o prijatie zmien na vyriešenie problému. Ďalšie informácie nájdete v téme Úprava dokumentácie v prehliadači.

Po otvorení ŽIADOSTI o prijatie zmien na riešenie problému sa vráťte k problému a pridajte komentár, ktorý odkazuje na vaše PR. Pomôže nám to sledovať problém a žiadosť o prijatie zmien dohromady. Ak chcete vytvoriť prepojenie na PR, použite znak libry (#), za ktorým nasleduje číslo PR. Ak je napríklad vaše ČÍSLO PR 4 210, zadáte do #4210 komentára.