Psalmで始めるOSS contribution

2022-05-27
PHPerのための「静的解析」を語り合うPHP TechCafe
https://rakus.connpass.com/event/245646/

Transcript

1. Psalmで始めるOSS contribution 2022/5/27 PHPerのための「静的解析」を語り合うPHP TechCafe LT
2. 自己紹介 •Hiroki Inoue •Software Engineer •Engineering Manager @ WHITEPLUS, Inc. 2
3. This talk is for OSS contributionに興味はあるが始め方がわからないPHPer 3
4. なぜPsalmなのか OSS contribution入門のハードルから紐解く 1. どこから手を付ければよいのかわからない。 2. プロジェクトやissueを選びあぐねる。 3. お作法などがわからず、不安。 4. 英語が苦手。 4
5. 1.どこから手を付ければよいのかわからない • 段取り[1]を調べる。 ⇒必ずしも自分でissueを立てなくてもよい。 • good first issue[2]で候補を探す。 1. OSSを選定して、フォークして …PRをだすという一連の流れ。ググるとたくさん情報が出てくる。 2. https://goodfirstissue.dev/ 5
6. 2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 6
7. 2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ 7
8. 2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 8
9. 2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 使ったことがあれば • 仕様を知っている。 • 何なら改善要望があったりもする。 9
10. 2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 使ったことがなくても興味があれば • 仕様を調べるモチベーションを保てる。 10
11. 3.お作法などがわからず、不安 • Contributing Guide[1]を確認する。 1. 例：https://github.com/vimeo/psalm/blob/4.x/CONTRIBUTING.md 11
12. 4.英語が苦手 Just practice 12
13. 4.英語が苦手 Tools empower you 13
14. なぜPsalmなのか for PHPer 1. PHPで書かれている。 2. 挙動が簡単に確認できる。 3. 静的解析はPHPの開発に欠かせない。 ⇒時間を投じる価値がある。 4. 入門者に配慮がある。 ⇒ドキュメントが整備されている。 good first issue , Help wanted なissueがある。 5. メンテナンスが続いている。 ⇒対応すべきissueがある。自分にもできるissueがある。 14
15. まとめ Psalmは初めてのcontributionに適している！という主張ではなく contributionするまでに考えたこと、やったことの事例紹介 15
16. ご清聴ありがとうございました 16