OSSやってみた話

Transcript

1. OSS活動やってみた話
 永和システムマネジメント
 青木将太郎

2. 自己紹介
 - 名前
 青木 将太郎
 - 今仕事でやってること
 Flutter + AWS Amplifyで
 ヘルスケア系のモバイルアプリ開発
 - 好きなもの
 Emacs、Org Mode、音楽

3. 最近
 OSS活動はじめました 

4. OSS活動とは？（一応）
 - オープンソースソフトウェア(OSS)の開発・保守に貢献する活動のこと
 - Pull Requestを出す 
 - Issueを起票する・コメントする 
 - 自分でOSSプロジェクトを公開する 

5. どうしてOSS活動を
 はじめたか

6. 理由①
 やってみたかったから

7. 漠然と憧れてた
 - OSS活動してる＝強強エンジニア感がある

8. 漠然と憧れてた
 - OSS活動してる＝強強エンジニア感がある
 - GitHubのプロフィールにカッコいいバッチがつく
 - Github Achivements 
 - ほしい
 

9. 理由②
 PRを出せそうなものを
 見つけた

10. 使っているライブラリでバグを見つけた
 - Flutterのライブラリ
 「health」を実務で利用している
 
 - プラットフォーム標準の
 ヘルスケアアプリと連携できる 
 - iOS: ヘルスケア
 - Android: ヘルスコネクト
 
 - 血圧計や体温計、体重計で測定したデータ をhealthでヘルスケアアプリに書き込もうとし ていた
 
 health
11. 使っているライブラリでバグを見つけた
 - Flutterのライブラリ
 「health」を実務で利用している
 
 - プラットフォーム標準の
 ヘルスケアアプリと連携できる 
 - iOS: ヘルスケア
 - Android: ヘルスコネクト
 
 - 血圧計や体温計、体重計で測定したデータ をhealthでヘルスケアアプリに書き込もうとし ていた
 
 health → iOSの血圧データだけうまく書き込めない

12. healthのリポジトリでissue発見

13. 開発者からのコメント

14. 開発者からのコメント
 要約：誰か直して

15. これを直せる人って...
 - FlutterでiOSのアプリを開発している
 - 開発しているアプリに血圧データを書き込む機能がある
 - 血圧計を持っている

16. これを直せる人って...
 
 
 - FlutterでiOSのアプリを開発している
 - 開発しているアプリに血圧データを書き込む機能がある
 - 血圧計を持っている
 （俺だ...）

17. ということで実装して
 PR出してみた

18. 無事マージされた🎉

19. 一回マージされると一気にハードルが下がった
 - issueにコメント
 - 自分はこうやったら動いたよ的な 
 - issue起票
 - 開発者が想定している動作なのか不具合なのかを質問 
 - ついでに不具合の場合はこうするといいのでは？というPRも作成 
 - Discussionにコメント
 - Discussionを作った人に賛成で私もその機能ほしいです！的な 

20. しかし

22. 👈このバッチがほしい！

24. is 何
 - その名も「starstruck 」
 - かっこいいバッチ(GitHub Archivement)のひとつ
 

25. is 何
 - その名も「starstruck 」
 - かっこいいバッチ(GitHub Archivement)のひとつ
 - 手に入れる方法
 16個以上のスターがつけられたリポジトリを作成する 
 

26. それから
 （スターが16個もらえそうな）
 OSS
 を作りはじめた

27. つくったもの

29. コレは何？
 
 
 Emacs (エディタ)の
 Org-Mode (文書の編集モード)の
 Org-Roam (ナレッジ管理用の拡張機能)の
 拡張機能である org-roam-ui を
 デジタルガーデン 化（ナレッジをサイトに公開）が簡単にできる 
 GitHub Action 

30. ややこしいので
 気になる方は記事を読んでください！
 https://zenn.dev/ikoamu/articles/7193dbcf62fff8

31. なんで作った？
 
 
 - 欲しかったから
 - 作れそうだったから
 - GitHub Actions
 - Lisp 
 - Java Script
 - SQL
 が分かれば作れそう 

32. なんで作った？
 
 
 - 欲しかったから
 - 作れそうだったから
 - GitHub Actions
 - Lisp 
 - Java Script
 - SQL
 が分かれば作れそう 
 - しかも意外と需要ありそう？ 
 - Discussionで58コメントされてる 
 （他は2、3件）

33. 意外とスターもらえるのでは？
 
 
 - Discussionにこんなの作ったよってコメントしてみよう
 
 
 
 
 - GitHub ActionsのMarketplaceで見つけてもらえるかも?
 

34. 記事も書いて宣伝
 
 
 https://zenn.dev/ikoamu/articles/7193dbcf62fff8

35. すると...

36. ぽつぽつとスターがつく！

37. 
 バグ報告や欲しい機能のリクエスト
 がたくさん来る！

38. issueに対応するととても感謝される🥹
 要約: 完璧すぎる。マジでサンクス

39. めちゃくちゃ嬉しい

40. モチベーション爆上がりで新機能も追加しまくる
 
 

41. モチベーション爆上がりで新機能も追加しまくる
 要約：これはアメイジング

42. めちゃくちゃ嬉しい

43. そして...

45. ⭐ ⭐ 🎉
46. やってよかったOSS活動
 
 
 - 一度参加してしまえばハードルはぐっと下がる
 - 自分で作ってOSSに公開したいという考えが芽生える
 - こんなツールがあったらいいな〜 → 自分でつくっちゃおうかな？ 
 - 業務で作った便利機能を一般化して公開できるかも？ 
 - 自分で作ったOSSプロジェクトに愛着が沸く
 - 自分のOSSをより良くするために勉強する 
 - 業務では得られない知識を得られる
 - before: GitHub Actions、Lisp、JS、SQLだけでこれ作れるだろうな〜 
 after: GitHub Actions、Lisp、JS、SQL、uniorg、org-html、Next.js、Fuse.js、 
 Chakra UI、GSON、BiBTeX、etc… 
 - 自分が作った物に対して直接感謝の言葉をもらえる

47. 
 というのが私のOSS活動やってみた話になります。 
 最後に
 OSS活動初心者向けTips 
 を話します

48. その① Claude.aiで翻訳
 
 
 - 普段はDeepLで翻訳してるけど、たまに一文丸々端折られて翻訳されることがある
 - Claudeで翻訳するとちゃんと全文訳してくれる
 - 英→日、日→英どちらもClaudeの翻訳が一番それっぽい
 
 （英語のおすすめの勉強方法があれば教えてください...）
 
 少しくらい端 折ってもい いっしょ
49. その② GitHubでライセンスファイルを作る
 
 
 - OSSを公開する時にライセンスどうする問題がある
 - 基本的なライセンスファイルはだいたいGitHubで簡単に作れる
 リポジトリ作成時にライセンスを選べる

50. その② GitHubでライセンスファイルを作る
 
 
 
 リポジトリ作成後もGitHubでLICENSEファイルを作成すると
 テンプレートが選べる

51. その③ リポジトリの説明ちゃんと書く
 
 
 - OSSプロジェクトを作ったら多くの人に使ってもらいたい
 → リポジトリのAboutをちゃんと書いておくと、GitHubの Topicsから見つけてもらえるかも？

52. その③ リポジトリの説明ちゃんと書く
 
 

53. その④ issueを出す時の書き始め、労いの言葉で始める
 
 
 - 開発者としてかなり嬉しいです
 - きっと開発者のモチベーションが高まり ます
 - 私のような（ちょろい）開発者の場合、対 応の優先順位が上がります

54. 以上！

55. OSS活動おすすめです！
 ご清聴ありがとうございました⭐