Sdílet prostřednictvím

Kontrola otevřených žádostí o přijetí změn na GitHubu

  • Článek

Tento článek vysvětluje, jak přispívat do Microsoft Learn kontrolou žádostí o přijetí změn a přidáním komentářů. Můžete si přečíst nová témata a zobrazit navrhované aktualizace před jejich publikováním tak, že zkontrolujete otevřenou frontu žádostí o přijetí změn ve veřejném úložišti GitHub. Zpětná vazba komunity na navrhované aktualizace pomáhá celé komunitě.

S komentáři a recenzemi k žádosti o přijetí změn můžete:

  • Přidejte komentáře k žádosti o přijetí změn a odpovězte na je.
  • Reagujte na komentáře s emoji, jako 👍je , ❤️ a 🎉 .

Požadavky

Vyhledání žádosti o přijetí změn

  1. V prohlížeči přejděte do úložiště na GitHubu, které chcete zkontrolovat. Pokud si nejste jistí, na které úložiště se má podívat, najděte si úložiště, které vás zajímá, v našem seznamu úložišť Microsoft Learn.

    Pokud procházíte dokumentaci a nevíte, do kterého úložiště patří, vyberte v horní části stránky ikonu Upravit tužku. Tato akce vás provede zdrojovým souborem na GitHubu. Název úložiště se zobrazí v levém horním rohu stránky. Například následující obrázek ukazuje umístění názvu úložiště pro azure-dev-docs úložiště.

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

  2. Zvolte kartu Žádosti o přijetí změn a zobrazte otevřené žádosti o přijetí změn pro toto úložiště. Pokud má úložiště velké množství žádostí o přijetí změn, použijte panel Filtry k filtrování podle popisku, autora a dalších. Nebo pomocí panelu hledání vyhledejte konkrétní dotazy.

    Screenshot of a GitHub repo showing the pull requests tab.

  3. Otevřete žádost o přijetí změn tak, že vyberete odkaz na název.

Kontrola žádosti o přijetí změn

  1. V žádosti o přijetí změn, kterou kontrolujete, vyberte kartu Změněné soubory.

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

  2. Porovnejte původní dokument s upraveným dokumentem. Původní dokument bude červeně a navržený dokument bude zelený. Každý přidaný text se zvýrazní v zeleném (novém) oddílu a veškerý odstraněný text se zvýrazní v červeném (původním) oddílu.

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

  3. Přidejte komentáře nebo navrhněte změny výběrem ikony plus (+) vlevo od řádku, ke které chcete přidat komentář. Pokud chcete vybrat více čar, vyberte a přetáhněte znaménko 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áře nebo návrhy můžete přidávat jenom na řádky, které byly upraveny v aktuální žádosti o přijetí změn. Pokud chcete udělat další změny, upravte tento soubor ve vlastní žádosti o přijetí změn.

  4. Otevře se pole. Zadejte své komentáře nebo otázky. Pokud chcete, můžete pomocí tlačítek na panelu nástrojů naformátovat text, přidat seznamy s odrážkami a číslovanými seznamy nebo vložit bloky kódu a obrázky.

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

  5. Můžete také navrhnout změnu textu v daném řádku.

    1. Na panelu nástrojů komentáře vyberte +- ikonu (pravděpodobně nejdále od levého ikony). Toto je tlačítko Vložit 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 vybraného řádku bude zahrnut do bloku kódu (uvnitř dvou sad backticks).

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

      Chcete-li navrhnout změny textu, které obsahují trojnásobně zaškrtnuté ohraničení kódu ('' ), nahraďte vnější/uzavřené suggestion zadní ticky vlnovkou (~~~).

    3. Upravte text. Pomocí tlačítek v poli komentáře můžete jednoduše formátovat, jako je tučné písmo, kurzíva a odrážky, nebo přímo použít prvky syntaxe Markdownu. Do tohoto pole můžete také přidat komentáře pod oddílem bloku kódu.

  6. Po vytvoření komentáře vyberte Zahájit revizi. Autor žádosti o přijetí změn bude upozorněn na vaše změny. Pokud jste v předchozím kroku použili tlačítko Vložit návrh , autor bude moct návrh potvrdit přímo do dokumentu.

    Pokud chcete do konverzace přenést někoho jiného, můžete v komentářích @mention další přispěvatele pomocí aliasu GitHubu. Zmínění uživatelé GitHubu dostanou e-mail obsahující váš komentář. Markdown můžete také použít v komentářích a Markdown komentáře se zobrazí po odeslání komentáře.

  7. Na kartě Konverzace si přečtěte komentáře. Pokud máte dotazy nebo komentáře, přidejte je do konverzace. Reakce na komentáře můžete přidat také tak, že v levém dolním rohu každého komentáře vyberete ikonu smajlíka.

Odeslání recenze

Po přidání všech komentářů do revize odešlete recenzi.

  1. Výběrem tlačítka Zkontrolovat změny v pravém horním rohu karty Soubory se změnami otevřete dialogové okno pro odeslání revize.
  2. Zadejte popisný souhrn kontroly.
  3. Vyberte přepínač požadovaného typu kontroly a pak zvolte Odeslat revizi.

Submitting a review in GitHub.

Autor žádosti o přijetí změn obdrží oznámení o kontrole.

Další kroky

Další informace o komentování a kontrolách najdete v těchto článcích v dokumentaci k GitHubu.