Text
Page: 1
OSS Gate ワークショップ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 2
アイスブレイク ✓ 目的 ✓ 周りの人と話しやすくなること せっかくだから相談しよう！ ✓ やること ✓ 参加目的をみんなに説明 ※内容より声を出すことが大事！ ✓ まずはサポーターから発声 順番はスムーズな進行のために指定しているだけ。 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 3
チャット：Element ✓ https://app.element.io/#/room/#oss-gate:matrix.org ✓ アナウンス：oss-gate/announce ✓ 今後もみんなとつながっていたい！ ✓ まず登録して挨拶しよう！ ✓ 終わったら今日の成果を自慢しよう！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 4
OSS Gate？ OSSの門？ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 5
門 境界にあるもの OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 6
扱う境界 OSS開 発 活発 自信ない 未参加者 参加者 興味あり 興味なし OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 7
ターゲット OSS開 発 活発 自信ない 未参加者 参加者 興味あり 興味なし OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 8
やりたいこと OSS開 発 活発 自信ない 未参加者 参加者 興味あり OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 9
未参加者→参加者 OSS開 発 活発 自信ない 未参加者 参加者 興味あり ワークショップで実現 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 10
OSS Gateとワークショップ ✓ OSS Gate ✓ [OSS開発参加者を継続的に増やす] 取り組み ✓ OSS Gateワークショップ ✓ […増やす]を実現するための1手段 ✓ 未経験者が経験者になると増える OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 11
どうして未経験？ ✓ （数人の参加者に聞く） ✓ 予想： ✓ やったことがないから なんとなく敷居が高いと感じる OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 12
ワークショップの重要事項 体験する 体験して大したことはないとわかる→敷居が下がる OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 13
体験して門をくぐる OSS開 発 活発 自信ない なんか不安だな… 未参加者 参加者 興味あり OSS Gate ワークショップ くぐってしまえば 別になんてことはなかった！ Powered by Rabbit 4.0.2
Page: 14
よりくぐりやすく OSS開 発 サポート 活発 自信ない 未参加者 参加者 興味あり OSS Gate ワークショップ 大丈夫だよー Powered by Rabbit 4.0.2
Page: 15
ワークショップの内容1 参加者のこと OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 16
立場一覧 ✓ ビギナー ✓ サポーター ✓ サポートメンター ✓ 進行役 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 17
ビギナー ✓ OSSの開発に参加したい ✓ でも参加したことはない ✓ OSSの開発に参加した事はある ✓ でもまだ自信がない OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 18
サポーター ✓ ビギナーのサポート係 ✓ OSS開発経験者 ✓ 初参加でも大丈夫！ ✓ 例：進行役がやることを随時説明 ✓ 例：サポートメンターがサポート OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 19
サポートメンター ✓ サポーターのサポート係 ✓ サポーター経験者 ✓ 会場各地でスポットサポート ✓ サポート例： ✓ うまくサポートできていない感… →相談しよう！ サポーター1人で完璧にサポートしなくてよい！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 20
進行役 ✓ 進行と全体を気にかける係 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 21
ワークショップの内容2 流れ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 22
今日の流れのポイント ✓ 未経験者の最初の1歩に最適化 ✓ ※OSSの開発方法はいろいろある ✓ ※やりたい事がある人は応相談 ✓ ※基本的にこのやり方でやろう！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 23
流れ 1. ユーザーとしてOSSを動かす 2. ↑で気づいた事を開発元に フィードバック OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 24
期待 ✓ 普段は気づいていないだけで 実はフィードバックポイントが あったことを体験して！ ✓ ※ググったり生成AIに聞いて回避していない？ そんなときどうしたらよいかはワークショップ内で！ ✓ フィードバックを体験して！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 25
ワークショップの内容3 ユーザーとして OSSを動かす OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 26
動かす流れ （詳細は後述） 1. 対象OSSを決める 2. 作業メモを書く場所を用意 3. 作業メモを書きながら 公式サイト・README通り 動かす OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 27
OSSとは ✓ オープンソースライセンスを 設定したソフトウェア ✓ https://opensource.org/licenses/ ✓ ライセンスを確認すれば OSSかどうかわかる ✓ OSS「っぽい」は存在しない OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 28
対象OSS決め ✓ ビギナーが決める ✓ 使っているOSSから選ぶ ブラウザの拡張機能・便利なコマンドラインツール等 無意識で使っている物の中にもOSSはある ✓ 難易度は気にしなくてよい！ サポーターがサポートするから！ ✓ サポーターは↑をサポート ✓ 自分の知らないOSSや言語でもよい ビギナーと一緒に悩んであげよう！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 29
対象OSS決めデモ デモ ✓ 最近使っているOSSは？ ✓ ライセンス確認→OK！ ✓ その中で一番ときめくのは？ ✓ ではそれにしましょう！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 30
動かすときのポイント ✓ 作業メモを書く ✓ 🔜メモを書く場所はこのあと作る ✓ なにかする毎に書く ✓ 例：ドキュメントを読み始めた ✓ 例：次のドキュメントを読み始めた OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 31
作業メモを書く場所を作る デモ 1. GitHub: oss-gate/workshop 2. ↑にissueを作る 3. 周囲のビギナーの人たちが 作ったissueにコメント OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 32
作業メモの例 ドキュメント通りインストールしたけど 失敗した。 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 33
よりよい作業メモの例 https://... のインストール手順をなぞろう！ （↑後から再度参照できるようにURLも書く） brewでインストールできるはずなのに失敗した （↑期待する結果） $ brew install XXX（←なにをしたか） （...コマンドの実行結果...） （↑実際の結果） XXX is not found ↑というようにパッケージがないと言われる OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 34
ユーザーとして動かす デモ 1. 公式サイトを開く 2. 作業メモを書く 3. 概要を読む 4. 作業メモを書く 5. ... OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 35
作業開始！ ●時▲分まで！ 1. 公式サイトを開く 2. 作業メモを書く 3. 概要を読む 4. 作業メモを書く 5. ... OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 36
ふりかえり1 …●時▲分！ ✓ これまでの活動を見直す機会 ✓ 目的： ✓ 他の人の視点での考え方を知る ✓ 作業ログが役に立つことを実感 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 37
ふりかえり1：デモ デモ ✓ ビギナー： ✓ 作業メモを読む ✓ サポーター： ✓ 気になることをビギナーに質問 ✓ フィードバックポイントを確認 ✓ 完了→issueにコメント OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 38
ふりかえり1：進め方 ✓ サポーターを他の人に交代 ✓ 対象ビギナーの作業ログを ディスプレイに映す ✓ ビギナーが作業メモを読む ✓ 時間が余ったら： ✓ 近くの他のビギナーにも説明 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 39
休憩 ●時▲分まで！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 40
現状確認 1. ユーザーとして動かす 2. ふりかえり1 3. フィードバックポイントを 発見！ 4. ↑をフィードバック OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 41
フィードバック ✓ upstream（開発元）に うまくいかなかったことを報告 ✓ ここで詰まった、を伝える ✓ こうだったらよかった、を伝える OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 42
報告方法 1. 整理する ✓ 自分の考えが文章になればOK 2. 開発者にとって わかりやすくなるように編集 3. 適切な場所に報告 ✓ GitHubのissueとか OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 43
1. 整理する ✓ 自分で自分の気持ちを理解 ✓ 自分が読んで理解できる文章に まとめられれば理解できている ✓ 自分が理解できていないことは 開発者にも伝えられない！ ✓ 作業メモに追記→サポーター確認 サポーターへ：メモ（断片）の文書化を手伝って 例：考えを整理できるような質問をする OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 44
整理方法 デモ ✓ 作業メモを開く ✓ フィードバック対象を決める ✓ 自分の気持ちを作業メモに追記 ✓ サポーターに確認依頼 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 45
2. 編集する ✓ 開発者にとって わかりやすくなるように編集 ✓ 報告方針をまとめているOSSもある 例：GitHubにあるCONTRIBUTING.md ✓ 作業メモに追記→サポーターに確認 サポーターへ：リーダブル化を手伝って 例：自分が開発者ならこう読めると開発者視点を伝える OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 46
編集の仕方 ✓ ポイント ✓ 相手がわかるように書く ✓ 例：省略しない（具体的に書く） OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 47
省略例 インストールしました。 動きませんでした。 どうしたらいいでしょうか？ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 48
省略しない例 ↓でインストール $ sudo apt install ... （...実行結果...） ↑のように失敗しました。 環境：Ubuntu 24.04 amd64 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 49
なぜ省略しないか ✓ 相手は私を知らないから ✓ 省略すると想像しないといけない ✓ だいたい想像は外れる ✓ 話が噛み合わない！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 50
省略しないとは ✓ 詳細を書く ✓ 実行したコマンド・実行結果 ✓ やったことを書く ✓ やっていないことを書く ✓ 期待した結果を書く OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 51
編集方法 デモ ✓ 作業メモを開く ✓ 自分の気持ちを開発者に伝わるように まとめて作業メモに追記 ✓ サポーターに確認依頼 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 52
3. 報告する ✓ 適切な場所に報告 ✓ OSSによって報告場所は違う ✓ サポーターへ ✓ 報告に二の足を踏んでいる人の 背中を押してあげて 例：開発者視点を伝える：自分ならこの報告をもらったら助かる OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 53
報告方法 デモ ✓ 報告方法を探す ✓ サポーターに後押ししてもらう ✓ まとめた報告内容を報告 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 54
報告 ●時▲分まで！ 1. 整理する 2. 開発者にとってわかりやすくなるように 編集する 3. 適切な場所に報告する 4. 報告したことをチャットで自慢！ ✓ https://app.element.io/#/room/#oss-gate:matrix.org OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 55
ふりかえり2：デモ デモ ✓ ビギナー： ✓ 作業メモを読む ✓ サポーター： ✓ よかったことをよい！と言う ✓ 気になることをビギナーに質問 ✓ 完了→issueにコメント OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 56
ふりかえり2：進め方 ✓ サポーターを他の人に交代 ✓ 対象ビギナーの作業ログを ディスプレイに映す ✓ ビギナーが作業メモを読む ✓ 時間が余ったら： ✓ 近くの他のビギナーにも説明 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 57
OSS開発関連情報 ✓ 生成AI OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 58
生成AIとOSS開発 ✓ OSS開発にも生成AIは使われ始めている ✓ よい付き合い方はまだ探り探り ✓ これは困るというのは見えてきている ✓ ポイント： 自分も開発チームの1人という振る舞い OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 59
生成AIで報告 ✓ 生成された報告は冗長なことが多い ✓ 無用な冗長さは開発者を疲弊させる ✓ 開発チームの1人としてどうしたい？ ✓ 必須：報告前に報告者がレビュー！ ✓ 報告者がそもそも理解できていること ✓ 開発者に聞かれたら自分で答えられるくらい ✓ 報告者が不要な情報を減らす OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 60
生成AIでプルリクエスト ✓ 大きなプルリクエストになりがち ✓ 大きなプルリクエストは開発者を疲弊させる ✓ 開発チームの1人としてどうしたい？ ✓ 必須：作成前に作成者がレビュー！ ✓ 詳細を理解する ✓ レビュー可能なサイズにする OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 61
プルリクエストとレビュー ✓ 狙いの1つ：関係者間での知識の共有 ✓ 作成者が未理解→知識の共有は進まない ✓ 作成者抜きで開発者が直接生成AIを使えばよい ✓ 開発チームの1人としてどうしたい？ ✓ 学んで次のプルリクエストに活かせる？ ✓ 学んだことを他の人に伝えられる？ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 62
生成AIとライセンス ✓ 機械が生成したものに著作権は発生しない ✓ 著作権があるコードの複製を生成しうる ✓ そのコードのライセンスが大事 ✓ ライセンスを守れれば再利用可能 ✓ ライセンスの問題がないことは プルリクエスト作成者が保証する OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 63
生成AIとコミット ✓ どのツールを使ったかの情報を残す ✓ GitならGenerated-By: ...などで記録 ✓ なにか問題があったときに調べられるように OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 64
生成AIとOSS開発 ✓ 生成したものを丸投げはダメ ✓ 生成したものを詳細まで理解した上で活用 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 65
まとめ ✓ 今日やったことを再確認 ✓ 明日からのことを確認 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 66
目的の確認 OSS開発未経験者 ↓ OSS開発 経験者 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 67
やったこと OSS開発参加を体験する 1. ユーザーとして動かす 2. フィードバック OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 68
体験時のポイント 常にメモ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 69
常にメモの理由 ✓ 詰まったところに気づくため ✓ いつもはスルーしていない？ ✓ 実はフィードバックポイント！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 70
詰まったところ ✓ OSS開発参加のチャンス！ ✓ ポジティブに捉えてみよう ✓ 実際に参加して楽しかった？ ✓ 直ると次の人はうまくいく ✓ 気分がいいね！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 71
気づいた？ ✓ コードを書くだけが OSS開発参加方法じゃない ✓ 使いはじめのユーザーだから できることもある ✓ やり方を知ればやれる ✓ 明日からもやってみよう！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 72
明日からのやり方 ✓ 自分が使っているOSSでも やってみよう a. ユーザーとして動かす b. 気になったことをまとめる c. フィードバック ✓ ↑失敗が怖い？ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 73
OSSと失敗 ✓ そもそも失敗と認識されない ✓ 少なくとも1発アウト！はほぼない ✓ 新規開発者は基本的にWelcome ✓ 失敗しても根に持たれない ✓ 失敗→改善：改善後を評価 ↓ 明日からオススメ方法をTry！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 74
メッセージ 不安がらずに OSSの開発を 楽しんで！ OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 75
来てよかった！と思ったら ✓ OSS Gateに継続参加！ ✓ チャット・ワークショップ・… ✓ 社内・コミュニティ向けワークショップを検討 ✓ OSS Gateを継続宣伝！ ✓ 周りの人を誘う ✓ ブログに書く OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 76
OSS Gateはメンバー募集中 ✓ 次のワークショップ開催日は… ✓ 開催する毎に門をくぐる人がいる！ ✓ 多くの人と協力して継続したい！ ✓ 会場提供・サポーター・進行役・… ✓ 次回の開催日をチェック！ ✓ https://app.element.io/#/room/#oss-gate:matrix.org ✓ アナウンス：oss-gate/announce OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 77
おねがい ✓ 今日のフィードバックを！ ✓ 次に活かしたい ✓ この後すぐ ✓ アンケート記入 ✓ アンケート結果をみんなで確認 OSS Gate ワークショップ Powered by Rabbit 4.0.2
Page: 78
アンケートの回答方法 1. github.com/oss-gate/workshop をfork 2. tutorial/retrospectives/YYYY-MM-DD-*** ✓ cp beginner.yaml beginner-***.yaml ✓ cp supporter.yaml supporter-***.yaml 3. git add → git commit → git push 4. github.com/自分のアカウント/workshopを開いて「Pull request」 OSS Gate ワークショップ Powered by Rabbit 4.0.2
