New Developers/Communication tips/cs

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 Phabricatoru:


 * 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í patch v Gerrit nebyl začleněn a dlouho v něm nebyly vidět žádné změny, můžete vylepšit stávající patch 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 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:


 * Přečtěte si a dodržujte kodex chování pro technické prostory Wikimedie.
 * Use : Instead of using terms that assume a gender identity (like "guys", "madam", or "sir") use the name of the person instead.

Ask in the right place
Private messages don't help others.
 * Ask in public: Do not send private messages if your conversation topic is not secret.
 * Ask and discuss in the best place:
 * In Phabricator tasks, discuss only specific questions about the topic of that task.
 * Ask general technical questions, like how to set up a development environment or how to fix problems with Gerrit, in the places listed on.
 * If you take part in an outreach program, then Zulip is for discussing questions about the outreach programs themselves.

Be patient
After you post your question:


 * Do not ask people for code review in a separate message. People receive Gerrit and Phabricator notifications and will respond when they can.
 * When seeking input and comments, especially during weekends and holidays, you may need to wait until business hours resume. On chat channels like IRC: if nobody answers, try again at a different time; don't just give up!
 * If you don't get an answer even after waiting and being patient, consider if other Communication channels might be a better place to ask your question.