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