OSS Gateワークショップ（チュートリアル）オフライン版 - OSS Gate - Rabbit Slide Show

OSS Gate
ワークショップ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

アイスブレイク
✓ 目的
✓ 周りの人と話しやすくなること
せっかくだから相談しよう！
✓ やること
✓ 参加目的をみんなに説明
※内容より声を出すことが大事！
✓ まずはサポーターから発声
順番はスムーズな進行のために指定しているだけ。
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

チャット：Element
✓ https://app.element.io/#/room/#oss-gate:matrix.org
✓ アナウンス：oss-gate/announce
✓ 今後もみんなとつながっていたい！
✓ まず登録して挨拶しよう！
✓ 終わったら今日の成果を自慢しよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gate？
OSSの門？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

門
境界にあるもの
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

扱う境界
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
興味なし
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ターゲット
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
興味なし
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

やりたいこと
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

未参加者→参加者
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
ワークショップで実現
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gateとワークショップ
✓ OSS Gate
✓ [OSS開発参加者を継続的に増やす]
取り組み
✓ OSS Gateワークショップ
✓ […増やす]を実現するための1手段
✓ 未経験者が経験者になると増える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

どうして未経験？
✓ （数人の参加者に聞く）
✓ 予想：
✓ やったことがないから
なんとなく敷居が高いと感じる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの重要事項
体験する
体験して大したことはないとわかる→敷居が下がる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

体験して門をくぐる
OSS開
発
活発
自信ない
なんか不安だな…
未参加者
参加者
興味あり
OSS Gate ワークショップ
くぐってしまえば
別になんてことはなかった！
Powered by Rabbit 4.0.2

よりくぐりやすく
OSS開
発
サポート活発
自信ない
未参加者
参加者
興味あり
OSS Gate ワークショップ
大丈夫だよー
Powered by Rabbit 4.0.2

ワークショップの内容1
参加者のこと
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

立場一覧
✓ ビギナー
✓ サポーター
✓ サポートメンター
✓ 進行役
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ビギナー
✓ OSSの開発に参加したい
✓ でも参加したことはない
✓ OSSの開発に参加した事はある
✓ でもまだ自信がない
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

サポーター
✓ ビギナーのサポート係
✓ OSS開発経験者
✓ 初参加でも大丈夫！
✓ 例：進行役がやることを随時説明
✓ 例：サポートメンターがサポート
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

サポートメンター
✓ サポーターのサポート係
✓ サポーター経験者
✓ 会場各地でスポットサポート
✓ サポート例：
✓ うまくサポートできていない感…
→相談しよう！
サポーター1人で完璧にサポートしなくてよい！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

進行役
✓ 進行と全体を気にかける係
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの内容2
流れ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

今日の流れのポイント
✓ 未経験者の最初の1歩に最適化
✓ ※OSSの開発方法はいろいろある
✓ ※やりたい事がある人は応相談
✓ ※基本的にこのやり方でやろう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

流れ
1. ユーザーとしてOSSを動かす
2. ↑で気づいた事を開発元に
フィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

期待
✓ 普段は気づいていないだけで
実はフィードバックポイントが
あったことを体験して！
✓ ※ググったり生成AIに聞いて回避していない？
そんなときどうしたらよいかはワークショップ内で！
✓ フィードバックを体験して！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの内容3
ユーザーとして
OSSを動かす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

動かす流れ
（詳細は後述）
1. 対象OSSを決める
2. 作業メモを書く場所を用意
3. 作業メモを書きながら
公式サイト・README通り
動かす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSSとは
✓ オープンソースライセンスを
設定したソフトウェア
✓ https://opensource.org/licenses/
✓ ライセンスを確認すれば
OSSかどうかわかる
✓ OSS「っぽい」は存在しない
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

対象OSS決め
✓ ビギナーが決める
✓ 使っているOSSから選ぶ
ブラウザの拡張機能・便利なコマンドラインツール等
無意識で使っている物の中にもOSSはある
✓ 難易度は気にしなくてよい！
サポーターがサポートするから！
✓ サポーターは↑をサポート
✓ 自分の知らないOSSや言語でもよい
ビギナーと一緒に悩んであげよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

対象OSS決めデモ
デモ
✓ 最近使っているOSSは？
✓ ライセンス確認→OK！
✓ その中で一番ときめくのは？
✓ ではそれにしましょう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

動かすときのポイント
✓ 作業メモを書く
✓
🔜メモを書く場所はこのあと作る
✓ なにかする毎に書く
✓ 例：ドキュメントを読み始めた
✓ 例：次のドキュメントを読み始めた
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業メモを書く場所を作る
デモ
1. GitHub: oss-gate/workshop
2. ↑にissueを作る
3. 周囲のビギナーの人たちが
作ったissueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業メモの例
ドキュメント通りインストールしたけど
失敗した。
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

よりよい作業メモの例
https://... のインストール手順をなぞろう！
（↑後から再度参照できるようにURLも書く）
brewでインストールできるはずなのに失敗した
（↑期待する結果）
$ brew install XXX（←なにをしたか）
（...コマンドの実行結果...）
（↑実際の結果）
XXX is not found
↑というようにパッケージがないと言われる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ユーザーとして動かす
デモ
1. 公式サイトを開く
2. 作業メモを書く
3. 概要を読む
4. 作業メモを書く
5. ...
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業開始！
●時▲分まで！
1. 公式サイトを開く
2. 作業メモを書く
3. 概要を読む
4. 作業メモを書く
5. ...
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1
…●時▲分！
✓ これまでの活動を見直す機会
✓ 目的：
✓ 他の人の視点での考え方を知る
✓ 作業ログが役に立つことを実感
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1：デモ
デモ
✓ ビギナー：
✓ 作業メモを読む
✓ サポーター：
✓ 気になることをビギナーに質問
✓ フィードバックポイントを確認
✓ 完了→issueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1：進め方
✓ サポーターを他の人に交代
✓ 対象ビギナーの作業ログを
ディスプレイに映す
✓ ビギナーが作業メモを読む
✓ 時間が余ったら：
✓ 近くの他のビギナーにも説明
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

休憩
●時▲分まで！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

現状確認
1. ユーザーとして動かす
2. ふりかえり1
3. フィードバックポイントを
発見！
4. ↑をフィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

フィードバック
✓ upstream（開発元）に
うまくいかなかったことを報告
✓ ここで詰まった、を伝える
✓ こうだったらよかった、を伝える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告方法
1. 整理する
✓ 自分の考えが文章になればOK
2. 開発者にとって
わかりやすくなるように編集
3. 適切な場所に報告
✓ GitHubのissueとか
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

1. 整理する
✓ 自分で自分の気持ちを理解
✓ 自分が読んで理解できる文章に
まとめられれば理解できている
✓ 自分が理解できていないことは
開発者にも伝えられない！
✓ 作業メモに追記→サポーター確認
サポーターへ：メモ（断片）の文書化を手伝って
例：考えを整理できるような質問をする
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

整理方法
デモ
✓ 作業メモを開く
✓ フィードバック対象を決める
✓ 自分の気持ちを作業メモに追記
✓ サポーターに確認依頼
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

2. 編集する
✓ 開発者にとって
わかりやすくなるように編集
✓ 報告方針をまとめているOSSもある
例：GitHubにあるCONTRIBUTING.md
✓ 作業メモに追記→サポーターに確認
サポーターへ：リーダブル化を手伝って
例：自分が開発者ならこう読めると開発者視点を伝える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

編集の仕方
✓ ポイント
✓ 相手がわかるように書く
✓ 例：省略しない（具体的に書く）
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略例
インストールしました。
動きませんでした。
どうしたらいいでしょうか？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略しない例
↓でインストール
$ sudo apt install ...
（...実行結果...）
↑のように失敗しました。
環境：Ubuntu 24.04 amd64
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

なぜ省略しないか
✓ 相手は私を知らないから
✓ 省略すると想像しないといけない
✓ だいたい想像は外れる
✓ 話が噛み合わない！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略しないとは
✓ 詳細を書く
✓ 実行したコマンド・実行結果
✓ やったことを書く
✓ やっていないことを書く
✓ 期待した結果を書く
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

編集方法
デモ
✓ 作業メモを開く
✓ 自分の気持ちを開発者に伝わるように
まとめて作業メモに追記
✓ サポーターに確認依頼
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

3. 報告する
✓ 適切な場所に報告
✓ OSSによって報告場所は違う
✓ サポーターへ
✓ 報告に二の足を踏んでいる人の
背中を押してあげて
例：開発者視点を伝える：自分ならこの報告をもらったら助かる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告方法
デモ
✓ 報告方法を探す
✓ サポーターに後押ししてもらう
✓ まとめた報告内容を報告
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告
●時▲分まで！
1. 整理する
2. 開発者にとってわかりやすくなるように
編集する
3. 適切な場所に報告する
4. 報告したことをチャットで自慢！
✓ https://app.element.io/#/room/#oss-gate:matrix.org
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり2：デモ
デモ
✓ ビギナー：
✓ 作業メモを読む
✓ サポーター：
✓ よかったことをよい！と言う
✓ 気になることをビギナーに質問
✓ 完了→issueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり2：進め方
✓ サポーターを他の人に交代
✓ 対象ビギナーの作業ログを
ディスプレイに映す
✓ ビギナーが作業メモを読む
✓ 時間が余ったら：
✓ 近くの他のビギナーにも説明
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS開発関連情報
✓ 生成AI
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとOSS開発
✓ OSS開発にも生成AIは使われ始めている
✓ よい付き合い方はまだ探り探り
✓ これは困るというのは見えてきている
✓ ポイント：
自分も開発チームの1人という振る舞い
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIで報告
✓ 生成された報告は冗長なことが多い
✓ 無用な冗長さは開発者を疲弊させる
✓ 開発チームの1人としてどうしたい？
✓ 必須：報告前に報告者がレビュー！
✓ 報告者がそもそも理解できていること
✓ 開発者に聞かれたら自分で答えられるくらい
✓ 報告者が不要な情報を減らす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIでプルリクエスト
✓ 大きなプルリクエストになりがち
✓ 大きなプルリクエストは開発者を疲弊させる
✓ 開発チームの1人としてどうしたい？
✓ 必須：作成前に作成者がレビュー！
✓ 詳細を理解する
✓ レビュー可能なサイズにする
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

プルリクエストとレビュー
✓ 狙いの1つ：関係者間での知識の共有
✓ 作成者が未理解→知識の共有は進まない
✓ 作成者抜きで開発者が直接生成AIを使えばよい
✓ 開発チームの1人としてどうしたい？
✓ 学んで次のプルリクエストに活かせる？
✓ 学んだことを他の人に伝えられる？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとライセンス
✓ 機械が生成したものに著作権は発生しない
✓ 著作権があるコードの複製を生成しうる
✓ そのコードのライセンスが大事
✓ ライセンスを守れれば再利用可能
✓ ライセンスの問題がないことは
プルリクエスト作成者が保証する
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとコミット
✓ どのツールを使ったかの情報を残す
✓ GitならGenerated-By: ...などで記録
✓ なにか問題があったときに調べられるように
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとOSS開発
✓ 生成したものを丸投げはダメ
✓ 生成したものを詳細まで理解した上で活用
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

まとめ
✓ 今日やったことを再確認
✓ 明日からのことを確認
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

目的の確認
OSS開発未経験者
↓
OSS開発経験者
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

やったこと
OSS開発参加を体験する
1. ユーザーとして動かす
2. フィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

体験時のポイント
常にメモ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

常にメモの理由
✓ 詰まったところに気づくため
✓ いつもはスルーしていない？
✓ 実はフィードバックポイント！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

詰まったところ
✓ OSS開発参加のチャンス！
✓ ポジティブに捉えてみよう
✓ 実際に参加して楽しかった？
✓ 直ると次の人はうまくいく
✓ 気分がいいね！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

気づいた？
✓ コードを書くだけが
OSS開発参加方法じゃない
✓ 使いはじめのユーザーだから
できることもある
✓ やり方を知ればやれる
✓ 明日からもやってみよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

明日からのやり方
✓ 自分が使っているOSSでも
やってみよう
a. ユーザーとして動かす
b. 気になったことをまとめる
c. フィードバック
✓ ↑失敗が怖い？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSSと失敗
✓ そもそも失敗と認識されない
✓ 少なくとも1発アウト！はほぼない
✓ 新規開発者は基本的にWelcome
✓ 失敗しても根に持たれない
✓ 失敗→改善：改善後を評価
↓
明日からオススメ方法をTry！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

メッセージ
不安がらずに
OSSの開発を
楽しんで！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

来てよかった！と思ったら
✓ OSS Gateに継続参加！
✓ チャット・ワークショップ・…
✓ 社内・コミュニティ向けワークショップを検討
✓ OSS Gateを継続宣伝！
✓ 周りの人を誘う
✓ ブログに書く
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gateはメンバー募集中
✓ 次のワークショップ開催日は…
✓ 開催する毎に門をくぐる人がいる！
✓ 多くの人と協力して継続したい！
✓ 会場提供・サポーター・進行役・…
✓ 次回の開催日をチェック！
✓ https://app.element.io/#/room/#oss-gate:matrix.org
✓ アナウンス：oss-gate/announce
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

おねがい
✓ 今日のフィードバックを！
✓ 次に活かしたい
✓ この後すぐ
✓ アンケート記入
✓ アンケート結果をみんなで確認
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

アンケートの回答方法
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

OSS Gate
ワークショップ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

アイスブレイク
✓ 目的
✓ 周りの人と話しやすくなること
せっかくだから相談しよう！
✓ やること
✓ 参加目的をみんなに説明
※内容より声を出すことが大事！
✓ まずはサポーターから発声
順番はスムーズな進行のために指定しているだけ。
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

チャット：Element
✓ https://app.element.io/#/room/#oss-gate:matrix.org
✓ アナウンス：oss-gate/announce
✓ 今後もみんなとつながっていたい！
✓ まず登録して挨拶しよう！
✓ 終わったら今日の成果を自慢しよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gate？
OSSの門？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

門
境界にあるもの
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

扱う境界
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
興味なし
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ターゲット
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
興味なし
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

やりたいこと
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

未参加者→参加者
OSS開
発
活発
自信ない
未参加者
参加者
興味あり
ワークショップで実現
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gateとワークショップ
✓ OSS Gate
✓ [OSS開発参加者を継続的に増やす]
取り組み
✓ OSS Gateワークショップ
✓ […増やす]を実現するための1手段
✓ 未経験者が経験者になると増える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

どうして未経験？
✓ （数人の参加者に聞く）
✓ 予想：
✓ やったことがないから
なんとなく敷居が高いと感じる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの重要事項
体験する
体験して大したことはないとわかる→敷居が下がる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

体験して門をくぐる
OSS開
発
活発
自信ない
なんか不安だな…
未参加者
参加者
興味あり
OSS Gate ワークショップ
くぐってしまえば
別になんてことはなかった！
Powered by Rabbit 4.0.2

よりくぐりやすく
OSS開
発
サポート活発
自信ない
未参加者
参加者
興味あり
OSS Gate ワークショップ
大丈夫だよー
Powered by Rabbit 4.0.2

ワークショップの内容1
参加者のこと
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

立場一覧
✓ ビギナー
✓ サポーター
✓ サポートメンター
✓ 進行役
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ビギナー
✓ OSSの開発に参加したい
✓ でも参加したことはない
✓ OSSの開発に参加した事はある
✓ でもまだ自信がない
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

サポーター
✓ ビギナーのサポート係
✓ OSS開発経験者
✓ 初参加でも大丈夫！
✓ 例：進行役がやることを随時説明
✓ 例：サポートメンターがサポート
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

サポートメンター
✓ サポーターのサポート係
✓ サポーター経験者
✓ 会場各地でスポットサポート
✓ サポート例：
✓ うまくサポートできていない感…
→相談しよう！
サポーター1人で完璧にサポートしなくてよい！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

進行役
✓ 進行と全体を気にかける係
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの内容2
流れ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

今日の流れのポイント
✓ 未経験者の最初の1歩に最適化
✓ ※OSSの開発方法はいろいろある
✓ ※やりたい事がある人は応相談
✓ ※基本的にこのやり方でやろう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

流れ
1. ユーザーとしてOSSを動かす
2. ↑で気づいた事を開発元に
フィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

期待
✓ 普段は気づいていないだけで
実はフィードバックポイントが
あったことを体験して！
✓ ※ググったり生成AIに聞いて回避していない？
そんなときどうしたらよいかはワークショップ内で！
✓ フィードバックを体験して！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ワークショップの内容3
ユーザーとして
OSSを動かす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

動かす流れ
（詳細は後述）
1. 対象OSSを決める
2. 作業メモを書く場所を用意
3. 作業メモを書きながら
公式サイト・README通り
動かす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSSとは
✓ オープンソースライセンスを
設定したソフトウェア
✓ https://opensource.org/licenses/
✓ ライセンスを確認すれば
OSSかどうかわかる
✓ OSS「っぽい」は存在しない
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

対象OSS決め
✓ ビギナーが決める
✓ 使っているOSSから選ぶ
ブラウザの拡張機能・便利なコマンドラインツール等
無意識で使っている物の中にもOSSはある
✓ 難易度は気にしなくてよい！
サポーターがサポートするから！
✓ サポーターは↑をサポート
✓ 自分の知らないOSSや言語でもよい
ビギナーと一緒に悩んであげよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

対象OSS決めデモ
デモ
✓ 最近使っているOSSは？
✓ ライセンス確認→OK！
✓ その中で一番ときめくのは？
✓ ではそれにしましょう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

動かすときのポイント
✓ 作業メモを書く
✓
🔜メモを書く場所はこのあと作る
✓ なにかする毎に書く
✓ 例：ドキュメントを読み始めた
✓ 例：次のドキュメントを読み始めた
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業メモを書く場所を作る
デモ
1. GitHub: oss-gate/workshop
2. ↑にissueを作る
3. 周囲のビギナーの人たちが
作ったissueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業メモの例
ドキュメント通りインストールしたけど
失敗した。
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

よりよい作業メモの例
https://... のインストール手順をなぞろう！
（↑後から再度参照できるようにURLも書く）
brewでインストールできるはずなのに失敗した
（↑期待する結果）
$ brew install XXX（←なにをしたか）
（...コマンドの実行結果...）
（↑実際の結果）
XXX is not found
↑というようにパッケージがないと言われる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ユーザーとして動かす
デモ
1. 公式サイトを開く
2. 作業メモを書く
3. 概要を読む
4. 作業メモを書く
5. ...
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

作業開始！
●時▲分まで！
1. 公式サイトを開く
2. 作業メモを書く
3. 概要を読む
4. 作業メモを書く
5. ...
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1
…●時▲分！
✓ これまでの活動を見直す機会
✓ 目的：
✓ 他の人の視点での考え方を知る
✓ 作業ログが役に立つことを実感
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1：デモ
デモ
✓ ビギナー：
✓ 作業メモを読む
✓ サポーター：
✓ 気になることをビギナーに質問
✓ フィードバックポイントを確認
✓ 完了→issueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり1：進め方
✓ サポーターを他の人に交代
✓ 対象ビギナーの作業ログを
ディスプレイに映す
✓ ビギナーが作業メモを読む
✓ 時間が余ったら：
✓ 近くの他のビギナーにも説明
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

休憩
●時▲分まで！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

現状確認
1. ユーザーとして動かす
2. ふりかえり1
3. フィードバックポイントを
発見！
4. ↑をフィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

フィードバック
✓ upstream（開発元）に
うまくいかなかったことを報告
✓ ここで詰まった、を伝える
✓ こうだったらよかった、を伝える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告方法
1. 整理する
✓ 自分の考えが文章になればOK
2. 開発者にとって
わかりやすくなるように編集
3. 適切な場所に報告
✓ GitHubのissueとか
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

1. 整理する
✓ 自分で自分の気持ちを理解
✓ 自分が読んで理解できる文章に
まとめられれば理解できている
✓ 自分が理解できていないことは
開発者にも伝えられない！
✓ 作業メモに追記→サポーター確認
サポーターへ：メモ（断片）の文書化を手伝って
例：考えを整理できるような質問をする
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

整理方法
デモ
✓ 作業メモを開く
✓ フィードバック対象を決める
✓ 自分の気持ちを作業メモに追記
✓ サポーターに確認依頼
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

2. 編集する
✓ 開発者にとって
わかりやすくなるように編集
✓ 報告方針をまとめているOSSもある
例：GitHubにあるCONTRIBUTING.md
✓ 作業メモに追記→サポーターに確認
サポーターへ：リーダブル化を手伝って
例：自分が開発者ならこう読めると開発者視点を伝える
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

編集の仕方
✓ ポイント
✓ 相手がわかるように書く
✓ 例：省略しない（具体的に書く）
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略例
インストールしました。
動きませんでした。
どうしたらいいでしょうか？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略しない例
↓でインストール
$ sudo apt install ...
（...実行結果...）
↑のように失敗しました。
環境：Ubuntu 24.04 amd64
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

なぜ省略しないか
✓ 相手は私を知らないから
✓ 省略すると想像しないといけない
✓ だいたい想像は外れる
✓ 話が噛み合わない！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

省略しないとは
✓ 詳細を書く
✓ 実行したコマンド・実行結果
✓ やったことを書く
✓ やっていないことを書く
✓ 期待した結果を書く
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

編集方法
デモ
✓ 作業メモを開く
✓ 自分の気持ちを開発者に伝わるように
まとめて作業メモに追記
✓ サポーターに確認依頼
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

3. 報告する
✓ 適切な場所に報告
✓ OSSによって報告場所は違う
✓ サポーターへ
✓ 報告に二の足を踏んでいる人の
背中を押してあげて
例：開発者視点を伝える：自分ならこの報告をもらったら助かる
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告方法
デモ
✓ 報告方法を探す
✓ サポーターに後押ししてもらう
✓ まとめた報告内容を報告
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

報告
●時▲分まで！
1. 整理する
2. 開発者にとってわかりやすくなるように
編集する
3. 適切な場所に報告する
4. 報告したことをチャットで自慢！
✓ https://app.element.io/#/room/#oss-gate:matrix.org
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり2：デモ
デモ
✓ ビギナー：
✓ 作業メモを読む
✓ サポーター：
✓ よかったことをよい！と言う
✓ 気になることをビギナーに質問
✓ 完了→issueにコメント
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

ふりかえり2：進め方
✓ サポーターを他の人に交代
✓ 対象ビギナーの作業ログを
ディスプレイに映す
✓ ビギナーが作業メモを読む
✓ 時間が余ったら：
✓ 近くの他のビギナーにも説明
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS開発関連情報
✓ 生成AI
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとOSS開発
✓ OSS開発にも生成AIは使われ始めている
✓ よい付き合い方はまだ探り探り
✓ これは困るというのは見えてきている
✓ ポイント：
自分も開発チームの1人という振る舞い
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIで報告
✓ 生成された報告は冗長なことが多い
✓ 無用な冗長さは開発者を疲弊させる
✓ 開発チームの1人としてどうしたい？
✓ 必須：報告前に報告者がレビュー！
✓ 報告者がそもそも理解できていること
✓ 開発者に聞かれたら自分で答えられるくらい
✓ 報告者が不要な情報を減らす
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIでプルリクエスト
✓ 大きなプルリクエストになりがち
✓ 大きなプルリクエストは開発者を疲弊させる
✓ 開発チームの1人としてどうしたい？
✓ 必須：作成前に作成者がレビュー！
✓ 詳細を理解する
✓ レビュー可能なサイズにする
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

プルリクエストとレビュー
✓ 狙いの1つ：関係者間での知識の共有
✓ 作成者が未理解→知識の共有は進まない
✓ 作成者抜きで開発者が直接生成AIを使えばよい
✓ 開発チームの1人としてどうしたい？
✓ 学んで次のプルリクエストに活かせる？
✓ 学んだことを他の人に伝えられる？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとライセンス
✓ 機械が生成したものに著作権は発生しない
✓ 著作権があるコードの複製を生成しうる
✓ そのコードのライセンスが大事
✓ ライセンスを守れれば再利用可能
✓ ライセンスの問題がないことは
プルリクエスト作成者が保証する
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとコミット
✓ どのツールを使ったかの情報を残す
✓ GitならGenerated-By: ...などで記録
✓ なにか問題があったときに調べられるように
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

生成AIとOSS開発
✓ 生成したものを丸投げはダメ
✓ 生成したものを詳細まで理解した上で活用
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

まとめ
✓ 今日やったことを再確認
✓ 明日からのことを確認
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

目的の確認
OSS開発未経験者
↓
OSS開発経験者
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

やったこと
OSS開発参加を体験する
1. ユーザーとして動かす
2. フィードバック
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

体験時のポイント
常にメモ
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

常にメモの理由
✓ 詰まったところに気づくため
✓ いつもはスルーしていない？
✓ 実はフィードバックポイント！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

詰まったところ
✓ OSS開発参加のチャンス！
✓ ポジティブに捉えてみよう
✓ 実際に参加して楽しかった？
✓ 直ると次の人はうまくいく
✓ 気分がいいね！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

気づいた？
✓ コードを書くだけが
OSS開発参加方法じゃない
✓ 使いはじめのユーザーだから
できることもある
✓ やり方を知ればやれる
✓ 明日からもやってみよう！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

明日からのやり方
✓ 自分が使っているOSSでも
やってみよう
a. ユーザーとして動かす
b. 気になったことをまとめる
c. フィードバック
✓ ↑失敗が怖い？
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSSと失敗
✓ そもそも失敗と認識されない
✓ 少なくとも1発アウト！はほぼない
✓ 新規開発者は基本的にWelcome
✓ 失敗しても根に持たれない
✓ 失敗→改善：改善後を評価
↓
明日からオススメ方法をTry！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

メッセージ
不安がらずに
OSSの開発を
楽しんで！
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

来てよかった！と思ったら
✓ OSS Gateに継続参加！
✓ チャット・ワークショップ・…
✓ 社内・コミュニティ向けワークショップを検討
✓ OSS Gateを継続宣伝！
✓ 周りの人を誘う
✓ ブログに書く
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

OSS Gateはメンバー募集中
✓ 次のワークショップ開催日は…
✓ 開催する毎に門をくぐる人がいる！
✓ 多くの人と協力して継続したい！
✓ 会場提供・サポーター・進行役・…
✓ 次回の開催日をチェック！
✓ https://app.element.io/#/room/#oss-gate:matrix.org
✓ アナウンス：oss-gate/announce
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

おねがい
✓ 今日のフィードバックを！
✓ 次に活かしたい
✓ この後すぐ
✓ アンケート記入
✓ アンケート結果をみんなで確認
OSS Gate ワークショップ
Powered by Rabbit 4.0.2

アンケートの回答方法
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

0 / 78