Noví vývojáři/Tipy pro vzájemnou komunikaci

This page is a translated version of the page New Developers/Communication tips and the translation is 100% complete.

Postupujte podle těchto tipů, abyste mohli efektivně komunikovat a získat pomoc od členů komunity.

Používejte úkoly Phabricatoru efektivně

Pokud plánujete pracovat na úkolu Phabricator u:

  • Není třeba žádat o povolení: Můžete pracovat na nepřidělených úkolech, aniž byste někoho požádali, aby vám je přidělil. Neexistuje žádná autorita, která přiděluje úkoly nebo koho je třeba se nejdříve zeptat.
    • Pokud úloha již obsahuje nedávnou opravu v Gerritu, vyberte jinou úlohu, na které chcete pracovat.
    • Pokud existující záplata v Gerrit nebyla začleněna a dlouho v ní nebyly vidět žádné změny, můžete vylepšit stávající záplatu na základě zpětné vazby v Gerritu a v úloze.
  • Udělej si průzkum: Když uvažujete o práci na úkolu, proveďte průzkum, než začnete kódovat. Podívejte se na kód, pokuste se pochopit, co má dělat, přečtěte si související dokumentaci a pokuste se najít místa, kde potřebujete provést změny kódu.
    • V úloze Phabricator použijte, k nalezení úložiště kódu pro daný úkol, značky projektu na postranním panelu.
    • Pokud vůbec netušíte, jak chybu opravit, zvažte nejprve nalezení něčeho jednoduššího.
  • Nemusíte oznamovat své plány, než začnete na úkolu pracovat, ale měli byste sdělit, že na úkolu pracujete.
    • Když začnete pracovat, nastavte se jako příjemce úkolu kliknutím na Upravit úkol... (edit task) v Phabricatoru a nastavte své uživatelské jméno Phabricator do pole Přiřazeno (assigned to). Toto sděluje ostatním, že na tom pracujete, takže neduplikují práci.
    • Když se změní vaše plány nebo zájmy: Pokud již na úkolu nepracujete, odeberte se jako zmocněnec úkolu. To ostatním říká, že mohou na úkolu pracovat a nebudou očekávat, že na něm budete stále pracovat.
  • Řiďte se etiketou Phabricatoru.
    • V úkolech Phabricatoru diskutujte pouze o konkrétních otázkách k tématu daného úkolu. Nepoužívejte Phabricator k pokládání obecných otázek, například jak nastavit vývojové prostředí nebo jak opravit problémy s Gerritem.

Pokládejte dobré otázky

  • Neváhejte a ptejte se...jen se ptejte!.
  • Buďte konkrétní a uveďte souvislosti: Namísto jednoduché otázky "Můžete mi poskytnout více informací?", "Prosím, veďte mě" nebo "Řekněte mi, jak začít", zahrňte do své otázky následující informace:
    • Čeho se snažíte dosáhnout?
    • Co jste už vyzkoušeli? Zkopírujte a vložte své příkazy a jejich výstup (pokud nejsou příliš dlouhé) namísto parafrázování vlastními slovy.
    • Co jste již během svého výzkumu zjistili? Zahrňte odkazy na kód, dokumentaci nebo jiné zdroje, které jste již konzultovali.
  • Při komunikaci používejte konkrétní názvy a předměty. "Koncept návrhu" nebo "Potřebuji pomoc" není konkrétní.
  • Udržujte konverzace čitelné: Když odpovídáte v Zulipu, v úkolech Phabricatoru nebo v emailových konferencích, citujte pouze části předchozích komentářů, které jsou relevantní pro vaši odpověď. Pokud citujete úplný předchozí komentář, ztěžujete čtení vláken.

Dodržujte komunikační zásady a osvědčené postupy

Než vyjádříte nebo odešlete svůj dotaz:

Zeptejte se na správném místě

  • Ptejte se veřejně: Neposílejte soukromé zprávy, pokud není vaše téma konverzace tajné. Soukromé zprávy ostatním nepomáhají.
  • Ptejte se a diskutujte na tom nejlepším místě:
    • V úkolech Phabricatoru diskutujte pouze o konkrétních otázkách k tématu daného úkolu.
    • Odpovědi na obecné technické otázky, například jak nastavit vývojové prostředí nebo jak opravit problémy s Gerritem, hledejte na místech uvedených na stránce Komunikace .
    • Pokud se účastníte outreachového programu, pak je Zulip vhodný pro diskuzi o otázkách týkajících se samotných terénních programů.

Buďte trpěliví

Po odeslání dotazu:

  • Nežádejte lidi o kontrolu kódu v samostatné zprávě. Lidé dostávají upozornění Gerritu a Phabricatoru a budou reagovat, až když budou moci.
  • Při vyhledávání vstupů a komentářů, zejména během víkendů a svátků, možná budete muset počkat, až se obnoví pracovní doba. Na chatovacích kanálech jako IRC: Pokud nikdo neodpoví, zkuste to znovu v jinou dobu. Jen tak to nevzdávejte!
  • Pokud ani po čekání a trpělivosti nedostanete odpověď, zvažte, zda by pro vaši otázku nemohly být lepší komunikační kanály.