コントリビューションの流れの概要
プロジェクトを知ろう
- コードを取得し、中身を知りましょう
$ git clone https://opendev.org/openstack/<your_project>
- 例:
$ git clone https://opendev.org/openstack/training-guides
- ユニットテストを実行する
- プロジェクトの IRC チャンネルに参加する
- レビュー中の変更を見る
- Join the openstack-discuss mailing list
注釈
Each project has its own purpose & culture.
プロジェクトに関わろう
- IRC チャンネルで会話する
- メーリングリストのプロジェクトに関連するメールスレッドを読み、議論に参加する
- 定期ミーティングに参加する
- バグの登録、修正、仕分けを行う
- blueprint や spec を登録する
- blueprint や spec を実装する
Building Your Persona
- 他の人のコードをレビューする
- Help fix the documentation
- Answer other's questions or help direct them to those who can
- ミーティングに参加する
- Let the PTL know you are interested in participating in the project
- Explain why you are interested and what are your strengths
- Ask how you can help the project
Building Your Persona
- Build a network
- 誰がどの領域が得意なのかを意識しましょう
- Ask questions in the channel or send direct messages
- Trust within the community
- Trust that your comments are valid
- Trust that you can write and review code
- Trust that you understand or have the willingness to understand the technology
- Trust that you are consistent and reliable and come back regularly
注釈
If people know you, you have a better chance at your code getting attention.
一般的なコントリビューションの流れ
- タスク (バグ、些細な修正、ドキュメント、実装) を選びます
- 手元のリポジトリーで新しいブランチを作成します
- コードを変更します
- テストの更新や追加を行います (ユニットテスト、機能テストなど)
- テストを実行します (ユニットテスト、機能テストなど)
- Create your commit and push upstream for review
注釈
We will go into this later on in more detail so hold off on answering detailed questions for now.
パッチをアップストリームに投稿すると
- Zuul and vendor CIs will review your patch
- コミュニティーメンバーがあなたのパッチをレビューします
- コメントに応答します
- 変更を行い、新しいパッチセットを投稿します
- マージ時の衝突を解消します
早く取り込まれるようにするには
- みんなのコメントにきちんと対応しましょう
- 辛抱強く
- コミュニケーションをとる
- 共同で作業する
これは忘れないでください: これはオープンソースです。物事はコミュニティーのスケジュールに基いて動きます。あなたのスケジュールに基いて動くわけではありません。