GitHub je platforma pro spolupráci

  • 8 min

Spolupráce je jádrem všeho, co GitHub dělá. Prošli jsme úložiště v první lekci modulu a zjistili jsme, že úložiště vám pomůžou uspořádat projekt a jeho soubory. V poslední lekci jsme se dozvěděli o žádostech o přijetí změn, což je způsob, jak sledovat změny provedené v projektu.

V této lekci se dozvíme o problémech a diskuzích. Jedná se o funkce, které přispívají k povaze spolupráce na platformě GitHub Enterprise.

Problémy

Problémy GitHubu se používají ke sledování nápadů, zpětné vazby, úkolů nebo chyb pro práci na GitHubu. Problémy je možné vytvářet různými způsoby, takže si můžete vybrat nejvhodnější metodu pracovního postupu.

Tento názorný postup popisuje, jak vytvořit problém z úložiště. Problémy je možné vytvořit také z:

  • Položka v seznamu úkolů
  • Poznámka v projektu
  • Komentář v issue nebo pull requestu.
  • Konkrétní řádek kódu.
  • Dotaz adresy URL.

Vytvoření issue z repozitáře

  1. Na GitHub.com přejděte na hlavní stránku úložiště.

  2. Pod názvem úložiště vyberte Problémy.

    Snímek obrazovky zobrazující horní část hlavní stránky úložiště se zvýrazněnou částí Problémy

  3. Vyberte Nový problém. Mělo by se otevřít prázdné pole pro zadání problému, které můžete vyplnit.

  4. Pokud vaše úložiště používá šablony problémů, měli byste získat seznam typů problémů, vyberte ten, který chcete použít.

    Pokud typ problému, který chcete otevřít, není součástí dostupných možností, vyberte Prázdný problém. Pokud nepoužíváte šablony, přejděte ke kroku 5.

    Pokud vaše úložiště používá formuláře problému, zobrazí se strukturovaný formulář, který se vyplní místo prázdné šablony problému. Formuláře pro hlášení problémů umožňují správcům shromažďovat konkrétní informace ve standardizované podobě.

    Snímek obrazovky s nabídkou šablon problémů se zvýrazněnou možností Otevřít prázdný problém

  5. Do pole Přidat název zadejte název problému.

  6. Do pole Přidat popis zadejte popis vašeho problému.

  7. Pokud jste správcem projektu, můžete problém někomu přiřadit, přidat ho na panel projektu, přidružit ho k milníku nebo použít popisek.

  8. Až budete hotovi, vyberte Odeslat nový problém.

Používejte popisky, zmínky a reakce k efektivní správě spolupráce a zvyšte viditelnost problémů. Šablony problémů pomáhají udržovat konzistentní strukturu a očekávání pro přispěvatele.

Některé konverzace můžou být vhodnější pro diskuze na GitHubu. Diskuze na GitHubu slouží k kladení a odpovídání na otázky, sdílení informací, vytváření oznámení a vedení nebo účast v konverzacích o projektu.

V další části se podíváme na diskuze a na to, jak tuto funkci nejlépe využít.

Diskuze

Diskuze jsou určené pro konverzace, které nemusí nutně být svázané s kódem , jako jsou otázky&a, nápady nebo obecná zpětná vazba. Podporují otevřenou, probíhající komunikaci ve sdíleném fóru a mohou být veřejná nebo soukromá v závislosti na viditelnosti úložiště.

V této sekci se dozvíte, jak:

  • Povolení diskuze v úložišti
  • Vytvoření nové diskuze a různých kategorií diskuzí

Podívejme se, jak povolit diskuzi ve vašem úložišti.

Povolení diskuze v úložišti

Vlastníci úložišť a ti, kteří mají přístup k zápisu, můžou uživatelům GitHubu povolit diskuze v komunitě ve svých veřejných a privátních úložištích. Viditelnost diskuze přebírá viditelnost z repozitáře, ve kterém byla vytvořena.

Při prvním povolení diskuzí GitHubu se zobrazí výzva ke konfiguraci uvítacího příspěvku.

  1. Na GitHub.com přejděte na hlavní stránku úložiště.

  2. Pod názvem úložiště vyberte Nastavení.

    Snímek obrazovky s horní částí hlavní stránky úložiště se zvýrazněnou částí Nastavení

  3. Posuňte se dolů do části Funkce a v části Diskuze vyberte Nastavit diskuze.

    Snímek obrazovky s polem Diskuze se zvýrazněným zeleným tlačítkem diskuze o nastavení

  4. V části Zahájit novou diskuzi upravte šablonu tak, aby odpovídala tónům a prostředkům vaší komunity.

  5. Vyberte Zahájit diskuzi.

Teď jste připraveni vytvořit novou diskuzi.

Vytvoření nové diskuze

Každý ověřený uživatel, který může zobrazit úložiště, může vytvořit diskuzi v daném úložišti. Pro diskuze na úrovni organizace může každý uživatel, který může zobrazit zdrojové úložiště, také vytvořit diskuzi.

  1. Na GitHub.com přejděte na hlavní stránku úložiště nebo organizace, kde chcete zahájit diskuzi.

  2. Pod názvem úložiště nebo organizace vyberte Diskuze.

    Snímek obrazovky s horní částí hlavní stránky úložiště se zvýrazněnou částí Diskuze

  3. Na pravé straně stránky vyberte Nová diskuze.

  4. Vyberte kategorii diskuze výběrem možnosti Začínáme. Všechny diskuze musí být umístěny v kategorii. Správci úložišť definují tyto kategorie.

    Snímek obrazovky nabídky výběru kategorie diskuze, se zvýrazněnou horní možností Oznámení a tlačítkem 'Začít' zvýrazněným.

Každá kategorie diskuze obsahuje jedinečný název, emoji a popis, aby bylo jasné jeho účel. Kategorie pomáhají správcům organizovat, jak jsou konverzace zařazovány. Lze je přizpůsobit tak, aby pomáhaly rozlišovat mezi kategoriemi typu Q&A a otevřenějšími diskusemi. Následující tabulka uvádí výchozí kategorie pro diskuze a jejich účel.

Kategorie Účel Formát
📣 Oznámení Aktualizace a novinky od správce projektů Oznámení
#️⃣ Obecné Cokoliv a vše, co je relevantní pro projekt Otevřená diskuze
💡 Nápady Nápady ke změně nebo vylepšení projektu Otevřená diskuze
🗳️ Hlasování Ankety s více možnostmi, o kterých může komunita hlasovat a diskutovat Hlasování
🙏 Otázky a Odpovědi Otázky pro komunitu, na které má odpovědět, s formátem otázek a odpovědí Otázky a odpovědi
🙌 Ukázka a vysvětlení Vytváření, experimenty nebo testy relevantní pro projekt Otevřená diskuze

Správci úložiště můžou připnout důležité diskuze na začátek karty Diskuze, aby se zlepšila viditelnost.

  1. V části Název diskuze zadejte název diskuze a v části Napsat zadejte text diskuze.

    Snímek obrazovky s zahájením nové diskuzní stránky s polem Název diskuze a polem obsahu je prázdné.

  2. Vyberte Zahájit diskuzi.

To popisuje, jak GitHub podporuje spolupráci prostřednictvím problémů a diskuzí. Teď se podíváme na to, jak můžete spravovat oznámení, přihlásit se k odběru vláken a začít se stránkami GitHubu.

Označení komentáře jako odpovědi

V diskuzi o stylu Q&A můžete komentář označit jako přijatou odpověď na původní otázku.

  1. Přejděte na diskuzi.
  2. Vyhledejte komentář, který nejlépe odpovídá na původní otázku.
  3. Pod komentářem vyberte Označit jako odpověď .

Komentář se zvýrazní, aby ostatní mohli řešení rychle najít. V případě potřeby můžete také zrušit označení odpovědi.

Odkaz na diskuzi v problému

Pokud diskuze vede k práci, kterou je potřeba sledovat, můžete diskuzi převést na problém.

  1. Přejděte na diskuzi, kterou chcete převést.
  2. Vyberte nabídku ... se třemi tečkami vpravo nahoře v diskusi.
  3. Vyberte možnost Odkázat v novém problému.
  4. Potvrďte název a popis nového hlášení.

To umožňuje sledovat konkrétní úkoly, které vycházejí z diskusí v komunitě.

Připnutí diskuze

Důležité diskuze můžete připnout na začátek stránky Diskuze, abyste měli lepší viditelnost.

  1. Přejděte na diskuzi, kterou chcete připnout.
  2. Vyberte nabídku ... (tři tečky) vpravo nahoře v diskusi.
  3. Vyberte Připnout diskuzi.

Připnuté diskuze jsou užitečné pro zvýraznění oznámení, důležitých otázek nebo průběžných témat, která by si komunita měla všimnout.