Psalmで始めるOSS contribution 2022/5/27 PHPerのための「静的解析」を語り合うPHP TechCafe LT

自己紹介 •Hiroki Inoue •Software Engineer •Engineering Manager @ WHITEPLUS, Inc. 2

This talk is for OSS contributionに興味はあるが始め方がわからないPHPer 3

なぜPsalmなのか OSS contribution入門のハードルから紐解く 1. どこから手を付ければよいのかわからない。 2. プロジェクトやissueを選びあぐねる。 3. お作法などがわからず、不安。 4. 英語が苦手。 4

1.どこから手を付ければよいのかわからない • 段取り[1]を調べる。 ⇒必ずしも自分でissueを立てなくてもよい。 • good first issue[2]で候補を探す。 1. OSSを選定して、フォークして …PRをだすという一連の流れ。ググるとたくさん情報が出てくる。 2. https://goodfirstissue.dev/ 5

2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 6

2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ 7

2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 8

2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 使ったことがあれば • 仕様を知っている。 • 何なら改善要望があったりもする。 9

2.プロジェクトやissueを選びあぐねる • 使ったことがあるものや興味のある分野から選択する。 なぜか？ Contributionするには • 仕様の理解が必要。 • 修正する理由が必要。 使ったことがなくても興味があれば • 仕様を調べるモチベーションを保てる。 10

3.お作法などがわからず、不安 • Contributing Guide[1]を確認する。 1. 例：https://github.com/vimeo/psalm/blob/4.x/CONTRIBUTING.md 11

4.英語が苦手 Just practice 12

4.英語が苦手 Tools empower you 13

なぜPsalmなのか for PHPer 1. PHPで書かれている。 2. 挙動が簡単に確認できる。 3. 静的解析はPHPの開発に欠かせない。 ⇒時間を投じる価値がある。 4. 入門者に配慮がある。 ⇒ドキュメントが整備されている。 good first issue , Help wanted なissueがある。 5. メンテナンスが続いている。 ⇒対応すべきissueがある。自分にもできるissueがある。 14

まとめ Psalmは初めてのcontributionに適している！という主張ではなく contributionするまでに考えたこと、やったことの事例紹介 15

ご清聴ありがとうございました 16