GitHub je platforma pro spolupráci
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 problému nebo žádosti o přijetí změn
- Konkrétní řádek kódu.
- Dotaz adresy URL.
Vytvoření problému z úložiště
Na GitHub.com přejděte na hlavní stránku úložiště.
Pod názvem úložiště vyberte Problémy.
Vyberte Nový problém.
Pokud vaše úložiště používá šablony problémů, vedle typu problému, který chcete otevřít, vyberte Začínáme.
Pokud typ problému, který chcete otevřít, není součástí dostupných možností, vyberte Otevřít 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 problémů umožňují správci shromažďovat konkrétní informace ve standardizovaném formátu.
Do pole Přidat název zadejte název problému.
Do pole Přidat popis zadejte popis vašeho problému.
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.
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í
Pojďme se ponořit do povolení diskuze 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 dědí viditelnost z úložiště, ve kterém jsou vytvořené.
Při prvním povolení diskuzí GitHubu se zobrazí výzva ke konfiguraci uvítacího příspěvku.
Na GitHub.com přejděte na hlavní stránku úložiště.
Pod názvem úložiště vyberte Nastavení.
Posuňte se dolů do části Funkce a v části Diskuze vyberte Nastavit diskuze.
V části Zahájit novou diskuzi upravte šablonu tak, aby odpovídala tónům a prostředkům vaší komunity.
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.
Na GitHub.com přejděte na hlavní stránku úložiště nebo organizace, kde chcete zahájit diskuzi.
Pod názvem úložiště nebo organizace vyberte Diskuze.
Na pravé straně stránky vyberte Nová diskuze.
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.
Každá kategorie diskuze obsahuje jedinečný název, emoji a popis, aby bylo jasné jeho účel. Kategorie pomáhají správci uspořádat způsob vytváření konverzací. Dají se přizpůsobit, aby pomohly rozlišit kategorie, které jsou konverzace typu Q&A nebo více otevřených konverzací. 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 |
| 💡 Ideje | Nápady ke změně nebo vylepšení projektu | Otevřená diskuze |
| 🗳️ Hlasování | Hlasování s více možnostmi pro komunitu 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 |
| 🙌 Zobrazení a řekněte | 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.
V části Název diskuze zadejte název diskuze a v části Napsat zadejte text diskuze.
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.
- Přejděte na diskuzi.
- Vyhledejte komentář, který nejlépe odpovídá na původní otázku.
- 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.
Převod diskuze na problém
Pokud diskuze vede k práci, kterou je potřeba sledovat, můžete diskuzi převést na problém.
- Přejděte na diskuzi, kterou chcete převést.
-
...V pravém horním rohu diskuze vyberte nabídku (tři tečky). - Vyberte Převést na problém.
- Potvrďte převod a vyberte úložiště, ve kterém chcete nový problém vytvořit.
Díky tomu je možné sledovat práci, která pochází z komunitních konverzací.
Připnutí diskuze
Důležité diskuze můžete připnout na začátek stránky Diskuze, abyste měli lepší viditelnost.
- Přejděte na diskuzi, kterou chcete připnout.
-
...V pravém horním rohu diskuze vyberte nabídku (tři tečky). - 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.