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