手頃な課題でOSSに初貢献してみよう / Good First Issue for Contributing to OSS

第3回名古屋若手Webエンジニア交流会
https://wakateweb-nagoya.connpass.com/event/78763/

Transcript

1. 手頃な課題でOSSに初貢献してみよう
   @smogami 2018-03-10
   第3回名古屋若手Webエンジニア交流会
   help wanted
   good first issue
   low hanging fruit
   

   View Slide

2. 名前: もがみ @smogami
   所属: 来栖川電算 プロダクトマネージャ
   機械学習研究者向けSaaS
   

   View Slide

3. 主催コミュニティ:
   • Scala読書会
   • 名古屋Java User Group
   協力（LT・会場提供など）：
   • Japan AWS User Group 名古屋支部
   • Nagoya.cloud.first
   • Nagoya Frontend User Group
   

   View Slide

4. みなさん
   Open Source Softwareに
   貢献してますか？
   

   View Slide

5. •OSSへ貢献してみた話
   •難しくない貢献の仕方
   今回の内容
   

   View Slide

6. Open Source Softwareと私たち
   • プログラミング言語
   • ビルドツール、開発生産性ツール
   • フレームワーク
   • DBや検索エンジンなどミドルウェア
   • ユーティリティ
   • そうしたOSSのドキュメント
   

   View Slide

7. こんなとき
   仕事で使っているOSSに
   どうしても足りない機能や
   解決しないと困るバグがある
   

   View Slide

8. どうする？
   機能をあきらめる
   解決されるまで待つ
   OSS使わず独自実装
   OSSに貢献する
   価値を届けられない。最終手段
   いつになるやら。その間に競合に出遅れるのでは…
   とりまOK。でもメンテ負担増、ライブラリ更新が…
   自分以外のOSSユーザもうれしい
   

   View Slide

9. 仕事で困ったのをきっかけに
   貢献（プルリク）してみた
   

   View Slide

10. わりとマージされて
    使ってるOSSが便利に
    

    View Slide

11. 他のOSSユーザからも喜ばれて、
    もっと続けたくなった
    

    View Slide

12. OSSの開発難しそう…
    自分にはムリムリ
    そう思っていた時期が私にもありました
    

    View Slide

13. OSSの開発難しそう…
    自分にはムリムリ
    難しい Issue （課題）ばかりじゃない。
    コア開発陣が時間を割けないため、誰かの
    貢献が必要なお手軽 Issue が結構ある
    

    View Slide

14. help wanted
    good first issue
    初心者に好適 手伝い募集
    low hanging fruit
    手が届く果物＝カンタンなわりに価値がある
    こんなラベルのIssue
    が初心者向け
    

    View Slide

15. • 内部を深く知らなくても取り組める
    カンタンな機能追加
    • コンパイラ警告の解消
    • ドキュメントの誤植や間違い修正
    • 新機能がドキュメントに書いてない
    具体的には
    

    View Slide

16. お手頃な Issue の探し方
    • 興味あるGitHubレポジトリの
    Issues をラベルでフィルター
    • まとめサイトを利用
    • https://help.github.com/articles/searching-issues-and-pull-
    requests/#search-by-the-labels-on-an-issue
    • http://github-help-wanted.com/
    • http://up-for-grabs.net/#/
    help wanted
    good first issue low hanging fruit
    

    View Slide

17. できそうな を探して
    ちょこちょこPR送ると楽しい
    help wanted
    

    View Slide

18. 初めてプルリクするときの注意
    • 普段使ってるOSSでも、そのビルドやテスト
    でつまずきがち。 CONTRIBUTING.md や
    wikiなどに書かれてるのを探して従う
    • コミットログには Issue番号を書かないほう
    が良さげ。GitHubのIssueページからコミッ
    トにリンクされ、rebaseしても消せない!!
    

    View Slide

19. コード以外でも立派な貢献
    「不具合っぽい挙動を見つけた」
    「書いてる通りにやったのに動かない」
    「こんな機能あればいいのに」
    • Issueを書いてみよう
    • もっといい解決策を教えてもらえるかも
    • 誰かが実装してくれるかも
    

    View Slide

20. OSS貢献してみて学べたこと
    • 普段やっていない技術分野の理解
    • OSSの継続的発展・普及には、難しい課題の解決だけ
    でなく、地道な課題の解決も必要
    • 貢献してもらいやすくする地ならしも大事
    • Issue のトリアージ（ラベル付け、閉じる）
    • 揉めた時の調整や決断（モデレーション）
    • CI（ビルドやテスト、ある種のレビューの自動化）
    • 開発を助けるツール：CI、コンパイラオプション
    

    View Slide

21. おわり
    

    View Slide