20220510_LT大会_OSSコントリビュート

Transcript

1. 大型連休何しよう…せや！OSSコントリ ビュートしよ！ 古川　健二 GitHub: @345dvl
2. 目次 - Why OSS Contribute? - いざ、初めてのOSSコントリビュート - どうやって探す？ - どんなイシューが良いのか？ - 探してるうちに・・・ - 更に・・・ - 更に更に - コントリビュートの手順 - ドキュメントのみ - ソースコード - 実際にPRを出してみた - 気付き、所感
3. - Why OSS Contribute? - いざ、初めてのOSSコントリビュート - どうやって探す？ - どんなイシューが良いのか？ - 探してるうちに・・・ - 更に・・・ - 更に更に - コントリビュートの手順 - ドキュメントのみ - ソースコード - 実際にPRを出してみた - 気付き、所感
4. Why OSS Contribute?
5. 1. 大型連休＋LTネタ作り
6. 大型連休＋LTネタ作り - 大型連休だし新しいことやってみたいなあ - そういえばLT大会やるって宣言しちゃったなあ - なんか話のネタになるようなこと・・・ - OSSコントリビュート、やってみるか
7. 2. 社外のプロダクトに触れる
8. 社外のプロダクトに触れる - 社内プロダクト以外のソースをあまり読まないことに気付いた - それで痛い目を見ることが最近多い devise(rubygem)とかfirebaseauth(golang package)とか - 外部のソースコードも臆さず読めるようになりたい - OSSコントリビュートはもってこいの教材 - コントリビュートにはソースの理解が必須
9. 3. 実績作り
10. 実績作り - 少し狡い話 - 今回はあくまで取っ掛かり - 改修規模も小さい - 今後も続けていくことで、自分のアウトプットとしてキャリアの助けになる
11. 4. 文字通り、貢献できる
12. - 他者のライブラリやWebサービスに貢献し、感謝されることでエンジニアとしての喜 びを味わえる - もちろん自社のプロダクト開発も貢献だが、新鮮さがあり、横の繋がりが増えることも 文字通り、貢献できる
13. - Why OSS Contribute? - いざ、初めてのOSSコントリビュート - どうやって探す？ - どんなイシューが良いのか？ - 探してるうちに・・・ - 更に・・・ - 更に更に - コントリビュートの手順 - ドキュメントのみ - ソースコード - 実際にPRを出してみた - 気付き、所感
14. いざ、初めてのOSSコントリビュート
15. どうやって探す？
16. - 普段よく使うOSS - 検索サービスを使って自分に合ったOSSを探す コントリビュート先をどう探すか
17. - 普段よく使うOSS - 検索サービスを使って自分に合ったOSSを探す　→今回はこちら コントリビュート先をどう探すか
18. どんなイシューが良いのか？
19. http://github-help-wanted.com/ - 自分に合ったコントリビュート先を探すことができる - “help wanted” “good for first” “easy”などのラベルがついたイシューを検索 - 言語で絞ることも可能 - 今回は言語を慣れているRuby、勉強中のGolangに絞った - 他にも同じようなサイトが多数ある どんなイシューが良いのか？
20. 探してるうちに・・・
21. https://github.com/rubyforgood/human-essentials/issues/2883 - Railsで書かれた在庫管理のWebサービス - 画面に日付を表示するロジックのバグ対応、ぱっと見で分かりやすい - 付いているラベルは“help wanted” “good for first” - これなら自分でも対応できそう 良さげなイシューを見つけた！
22. 更に・・・
23. typoの修正はOSSコントリビュートの第一歩として最適と古事記にも書いてある typoも見つけた
24. 更に更に
25. > This application is an inventory management system that is built to address the needs of Diaper Banks as directly and explicitly as possible. もともとはおむつの在庫管理システムとして構築されたサービスとのこと
26. > This application is an inventory management system that is built to address the needs of Diaper Banks as directly and explicitly as possible. もともとはおむつの在庫管理システムとして構築されたサービスとのこと →妊娠育児関連サービスを開発している身としては出会うべくして出会ったOSSと言える
27. - Why OSS Contribute? - いざ、初めてのOSSコントリビュート - どうやって探す？ - どんなイシューが良いのか？ - 探してるうちに・・・ - 更に・・・ - 更に更に - コントリビュートの手順 - ドキュメントのみ - ソースコード - 実際にPRを出してみた - 気付き、所感
28. コントリビュートの手順
29. ドキュメントのみ
30. ドキュメント修正のみの場合は、GitHubの画面上で編集し、直接PRの作成が可能。 下記の通り、ドキュメント編集のみの場合でも自動でforkされる ドキュメントのみの修正
31. ソースコード
32. - 基本的には下記の流れで開発する - 通常の開発と異なるのは、細かい点を除けば最初にforkが必要な点くらい - かんたん！ 1. OSSを自リポジトリにfork 2. ローカルにcloneし、通常通りに開発 3. 元リポジトリにPRを提出 4. 必要に応じて指摘を対応 5. 問題無ければマージしてもらう ソースコードの修正
33. 実際にPRを出してみた
34. あっさりマージされました（そりゃそう） まずはtypo修正
35. - こちらも特に指摘も無くマージされました - 表示ロジック（JavaScript）修正だけでなくストロングパラメータが足りていないという バグを見つけ、併せて対応しましたが特にコメントが無かったのは少し寂しかったで す;) 日付表示ロジックの改修
36. - Why OSS Contribute? - いざ、初めてのOSSコントリビュート - どうやって探す？ - どんなイシューが良いのか？ - 探してるうちに・・・ - 更に・・・ - 更に更に - コントリビュートの手順 - ドキュメントのみ - ソースコード - 実際にPRを出してみた - 気付き、所感
37. 気付き・所感
38. - 思ったより簡単 - 通常の開発と異なるのは、細かい点を除けば最初にforkが必要な点くらい - 日頃から使用しているOSSの不便に思う点や不具合などに敏感になっておくと良さ そう - いざOSS貢献したい！と思っても、適当なイシューを見つけるまでが大変。今回 は改修より検索の方が時間がかかった - 今後は自分で直そう、とかイシュー立てよう、と当事者意識を持ってOSSに接す ることができそう - 簡易な修正でも、英語で知らないエンジニアにPRを出すのは緊張する - その分PR通るとやっぱり嬉しい - 次はもっと時間を取って難しいライブラリやイシューに挑戦したい 気付き・所感
39. ご清聴ありがとうございました！