新規開発者/コミュニケーションのヒント
効果的にコミュニケーションを取り、コミュニティのメンバーから支援を得るために、これらのヒントに従ってください。
効果的にPhabricatorタスクを使う
Phabricator タスクに取り組む予定がある場合:
- 許可を求める必要はありません: 未割り当てのタスクには、誰かに割り当ててもらうことなく取り組めます。 タスクを割り当てる権限者や、事前に許可を求める必要のある相手はいません。
- 既に Gerrit に最近のパッチがあるタスクは避け、代わりに別のタスクに取り組んでください。
- Gerrit に既存のパッチがあり、長期間マージされず変更もない場合は、Gerrit やタスク内のフィードバックに基づいてその既存のパッチを改善できます。
- Do your research: タスクに取り組むことを検討する際は、コーディングを始める前に調査を行ってください。コードを確認し、それが何を行うことを意図しているのかを理解し、関連するドキュメントを読み、どこにコードの変更が必要かを見つけてください。
- Phabricator タスクでは、サイドバーのプロジェクト タグを使用して、そのタスクのコード リポジトリを見つけてください。
- バグの修正方法がまったく分からない場合は、まずはより簡単なものを探すことを検討してください。
- タスクに取り組む前に計画を表明する必要はありませんが、そのタスクに取り組んでいることは伝えるべきです。
- 作業を開始したら、Phabricator で Edit Task… をクリックし、Assigned To フィールドに自分の Phabricator ユーザー名を設定して、自分をタスクの担当者に設定してください。 これにより、自分がそのタスクに取り組んでいることが他の人に伝わり、作業の重複を防げます。
- 計画や関心が変わった場合: そのタスクに取り組まなくなった場合は、自分をタスクの担当者から外してください。 これにより、他の人がそのタスクに取り組めることが伝わり、あなたが引き続き取り組んでいるとは期待されなくなります。
- Phabricator のエチケットに従ってください。
- Phabricator のタスクでは、そのタスクのトピックに関する具体的な質問のみを議論してください。 Phabricator を、開発環境の設定方法や Gerrit の問題の解決方法などの一般的な質問をするために使用しないでください。
- 「私のパッチをレビューしてください」や「このリンクにパッチを提出しました」といっただけのコメントは投稿しないでください。 コミット メッセージを正しく整形すれば、パッチは自動的にタスクに関連付けられます。また、パッチの提出は既にレビュー依頼を意味するため、それを明示しても何も追加されません。
優れた質問を執筆する
- 質問してよいかを尋ねるのではなく、すぐに質問してください
- 具体的にし、文脈を提供してください: 単に「詳しい情報を教えてください」「案内してください」「どのように始めればよいか教えてください」と尋ねるのではなく、質問には以下の情報を含めてください:
- 何を達成しようとしていますか?
- 既に何を試しましたか? コマンドとその出力 (長すぎない場合) を、自分の言葉で言い換えるのではなくコピーして貼り付けてください。
- これまでの調査で何が分かりましたか? 既に参照したコード、説明文書、その他のリソースへのリンクを含めてください。
- コミュニケーションでは、具体的なタイトルや件名を使用してください。 「提案ドラフト」や「ヘルプが必要です」は具体的ではありません。
- 会話を読みやすく保つ: Zulip、Phabricator のタスク、メーリング リストで返信する際は、前のコメントから自分の回答に関連する部分だけを引用してください。 以前のコメント全体を引用すると、スレッドが読みにくくなります。
コミュニケーションの方針と推奨手順に従う
質問を送信または投稿する前に:
- ウィキメディア技術空間の行動規範を読み、それに従ってください。
- 包括的言語 を使用してください: 「guys」「madam」「sir」などのように性別を前提とする表現の代わりに、その人の名前を使用してください。
適切な場所で尋ねる
- 公開で質問する: 会話の内容が秘密でない場合は、プライベート メッセージを送らないでください。 プライベート メッセージは他の人の助けにはなりません。
- 最適な場所で質問し、議論する:
- Phabricator のタスクでは、そのタスクのトピックに関する具体的な質問のみを議論してください。
- 開発環境のセットアップ方法や Gerrit の問題の解決方法などの一般的な技術的な質問は、コミュニケーション に記載されている場所で行ってください。
- アウトリーチ プログラムに参加している場合、Zulip はアウトリーチ プログラム自体に関する質問を議論するための場です。
辛抱強くあれ
質問を投稿した後:
- 別のメッセージでコード レビューを依頼しないでください。 人々は Gerrit や Phabricator の通知を受け取り、対応できるときに返信します。
- 入力やコメントを求める際、特に週末や休日の場合は、業務時間に戻るまで待つ必要がある場合があります。 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.