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 kontext: 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:
 * What are you trying to achieve?
 * What have you already tried? Copy and paste your commands and their output (if not too long) instead of paraphrasing in your own words.
 * What have you found out already during your research? Include links to code, documentation, or other resources you already consulted.
 * Use specific titles and subject lines in your communication. "Proposal draft" or "Need help" is not specific.
 * Keep conversations readable: When you reply in Zulip, in Phabricator tasks, or on mailing lists, only quote sections of previous comments that are relevant to your response. If you quote a complete previous comment, it makes threads hard to read.

Follow communication policies and best practices
Before you send or post your question:


 * Read and follow the code of conduct for Wikimedia technical spaces.
 * 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.