Zdieľať cez

Kontrola otvorených žiadostí o prijatie zmien v službe GitHub

  • Článok

Tento článok vysvetľuje, ako prispievať do služby Microsoft Learn tým, že skontrolujete žiadosti o prijatie zmien a pridajú sa vaše komentáre. Môžete si prečítať nové témy a zobraziť navrhované aktualizácie ešte pred ich publikovaním, a to tak, že skontrolujete otvorený front PR odkladacieho priestoru v službe GitHub. Pripomienky komunity k navrhovaným zmenám pomáhajú všetkým jej členom.

S komentármi a recenziami PR môžete:

  • Pridajte a odpovedajte na komentáre k žiadosti o prijatie zmien.
  • Reaguje na komentáre s emojis, ako 👍, ❤️ a 🎉 .

Požiadavky

Vyhľadanie žiadosti o prijatie zmien

  1. V prehliadači prejdite do odkladacieho priestoru v službe GitHub, ktorý chcete skontrolovať. Ak si nie ste istí, na ktorý odkladací priestor sa máte pozrieť, nájdite ho, ktorý vás zaujíma v našom zozname odkladacích priestorov služby Microsoft Learn.

    Ak prehľadávate dokumentáciu a neviete, do ktorého odkladacieho priestoru patrí, vyberte v hornej časti stránky ikonu ceruzky Upraviť . Táto akcia vás vezme do zdrojového súboru v službe GitHub. Názov odkladacieho priestoru sa zobrazí v ľavom hornom rohu stránky. Nasledujúci obrázok napríklad zobrazuje umiestnenie názvu odkladacieho azure-dev-docs priestoru.

    Screenshot of a GitHub article page showing the repo name in the upper left-hand corner of the page.

  2. Vyberte kartu Žiadosti o prijatie zmien, aby sa zobrazili otvorené žiadosti o prijatie zmien pre daný odkladací priestor. Ak odkladací priestor obsahuje veľa žiadosti o prijatie zmien, 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.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Výberom prepojenia na názov otvorte PR.

Revízia žiadosti o prijatie zmien

  1. V PR, ktorú kontrolujete, vyberte kartu Súbory zmenené .

    Screenshot of tabs on the GitHub pull request page. The tab titled Files Changed is highlighted.

  2. Porovnajte pôvodný dokument s upraveným. Pôvodný dokument bude červený a navrhovaný dokument bude zelený. Všetok pridaný text sa zvýrazní v zelenej (novej) časti a všetok odstránený text sa zvýrazní v červenej (pôvodnej) časti.

    Screenshot of a GitHub Files Changed page. An example of original content highlighted in red and edited content highlighted in green is displayed.

  3. Pridajte komentáre alebo navrhnite zmeny výberom ikony so znamienkom plus (+) naľavo od riadka, ku ktorého chcete pridať komentár. Ak chcete vybrať viacero riadkov, vyberte a presuňte znamienko plus.

    Screenshot of a GitHub Files Changed page. The plus sign icon, intended for the user to select to enter in-line comments, is featured.

    Komentáre alebo návrhy môžete pridávať iba do riadkov, ktoré boli upravené v aktuálnej žiadosti o prijatie zmien. Ak chcete vykonať ďalšie zmeny, upravte tento súbor vo vlastnej žiadosti o prijatie zmien.

  4. Otvorí sa pole. Zadajte tam svoje komentáre alebo otázky. Ak chcete, môžete tlačidlá na paneli s nástrojmi použiť na formátovanie textu, pridanie zoznamov s odrážkami a číslovaných zoznamov alebo vloženie blokov kódu a obrázkov.

    Screenshot of a GitHub Files Changed page. The comment box element is featured.

  5. Môžete tiež navrhnúť zmenu textu v tomto riadku.

    1. Na paneli s nástrojmi pre komentár vyberte +- ikonu (pravdepodobne ikonu najďalej po ľavej strane). Toto je tlačidlo Vložiť návrh .

      Screenshot of tabs in a comment box on the GitHub Files Changed page. The tab with a + and - icon is highlighted.

    2. Text z vybratého riadka sa zahrnie do bloku kódu (vo vnútri dvoch množín zadných apostrofov).

      Screenshot of a comment box on the GitHub Files Changed page. An example of how to write the syntax for a suggestion is displayed.

      Ak chcete navrhnúť zmeny textu, ktoré obsahujú ohradenie kódu s tromi začiarknutými políčkami (''),nahraďte vonkajšie/uzavreté suggestion opačné apostrofy pomôckami (~~~).

    3. Upraviť text. Použite tlačidlá v poli s komentármi na jednoduché formátovanie, ako je napríklad tučné písmo, kurzíva a odrážky, alebo použite priamo prvky syntaxe jazyka Markdown. Do tohto poľa môžete pridávať aj komentáre pod časťou s blokom kódu.

  6. Po vytvorení komentára vyberte položku Spustiť kontrolu. Autor žiadosti o prijatie zmien bude o vašich zmenách informovaný. Ak ste v predchádzajúcom kroku použili tlačidlo Vložiť návrh , autor bude môcť potvrdiť svoj návrh priamo do dokumentu.

    Ak chcete do konverzácie preniesť niekoho iného, môžete vo svojich komentároch @mention iných prispievateľov prostredníctvom ich aliasu GitHub. Spomenutí používatelia služby GitHub dostanú e-mail s vaším komentárom. Vo svojich komentároch môžete tiež použiť jazyk Markdown a po odoslaní komentára sa vykreslí jazyk Markdown vášho komentára.

  7. Na karte Konverzácie si prečítajte komentáre. Ak máte otázky alebo komentáre, pridajte ich do konverzácie. K komentárom môžete pridať aj reakcie výberom ikony usmiatej tváre v ľavom dolnom rohu každého komentára.

Odoslanie recenzie

Keď do recenzie pridáte všetky svoje komentáre, odošlite recenziu.

  1. Výberom tlačidla Skontrolovať zmeny v pravom hornom rohu karty Súbory zmenené otvorte dialógové okno Revízia odoslania.
  2. Zadajte popisný súhrn recenzie.
  3. Vyberte prepínač pre požadovaný typ recenzie a potom vyberte položku Odoslať recenziu.

Submitting a review in GitHub.

Autor ŽIADOSTI o prijatie zmien dostane oznámenie o kontrole.

Ďalšie kroky

Ak chcete získať ďalšie informácie o komentovaní a recenziách, pozrite si tieto články v dokumentácii služby GitHub.