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

OSS Gate
ワークショップ
オンライン版
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

雑談タイム
✓ せっかくなので色々質問してみ
よう
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

チャット：Discord
✓ ボイスチャンネル
✓#一般：全体向けアナウンス
✓#グループN：各グループの作業用
✓ テキストチャンネル
✓#YYYY-MM-DD：今日の連絡用
✓#グループN：各グループの連絡用
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

チャット：Gitter
✓ gitter.im/oss-gate/${地域}
例：https://gitter.im/oss-gate/tokyo
✓ オンラインで相談できる場所
✓ 今日は連絡用に使う
✓登録してなにか書き込もう！
✓ 明日からも使おう！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

OSS Gate？
OSSの門？
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

門
境界にあるもの
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

OSS開発者やOSSコントリ
ビューターってどんなイメー
ジ？
✓ 予想：
✓技術力が高い人
すごい人
意識が高い人
別世界の人
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

実際は
✓ OSSプロジェクトに
関わってみようと思えた人
✓ 関わってしまった人
✓ 関わるとメリットが大きい人
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

ワークショップの内容1
参加者のこと
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

進行役
✓ 進行と全体を気にかける係
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

ワークショップの内容2
流れ
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

期待
✓ 普段は気づいていないだけで
実はフィードバックポイントが
あったことを体験して！
✓※普段、ググってブログやQiitaで回
避策を探していませんか？
そんなときどうしたらよいかはワークショップ内で！
✓ フィードバックを体験して！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

ワークショップの内容3
ユーザーとして
OSSを動かす
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

対象OSS決め
✓ ビギナーが決める！
✓こちらから出す「課題」は無い
✓ サポーターは↑をサポート
✓自分の知らないOSSや言語でもよい
ビギナーと一緒に悩んであげよう！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

対象OSS決めのヒント
✓ 使っているOSSから選ぶ
ブラウザの拡張機能・便利なコマンドラインツール等
無意識で使っている物の中にもOSSはある
✓難易度は気にしなくてよい！
サポーターがサポートするから！
✓小規模なプロジェクトや
新しめのプロジェクトは狙い目
フィードバックできる部分が多い
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

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

休憩/雑談タイム
●時▲分まで！
✓ せっかくなので色々質問してみ
よう
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

報告
●時▲分まで！
前半と同じサポーターに見てもらう
1. 整理する
2. 開発者にとってわかりやすく
なるように編集する
3. 適切な場所に報告する
4. ...
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

目的の確認
OSS開発未経験者
↓
OSS開発経験者
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

OSS Gateはメンバー募集中
✓ 次のワークショップ開催日は…
✓開催する毎に門をくぐる人がいる！
✓多くの人と協力して継続したい！
✓会場提供・サポーター・進行役・…
✓ チャットで色々話してるよ！
✓ https://gitter.im/oss-gate/${地域}
✓ 例：https://gitter.im/oss-gate/tokyo
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

おねがい
✓ 今日のフィードバックを！
✓次に活かしたい
✓ この後すぐ
✓アンケート記入
✓アンケート結果をみんなで確認
OSS Gateワークショップオンライン版
Powered by Rabbit 3.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 3.0.2

OSS Gate
ワークショップ
オンライン版
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

雑談タイム
✓ せっかくなので色々質問してみ
よう
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

チャット：Discord
✓ ボイスチャンネル
✓#一般：全体向けアナウンス
✓#グループN：各グループの作業用
✓ テキストチャンネル
✓#YYYY-MM-DD：今日の連絡用
✓#グループN：各グループの連絡用
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

チャット：Gitter
✓ gitter.im/oss-gate/${地域}
例：https://gitter.im/oss-gate/tokyo
✓ オンラインで相談できる場所
✓ 今日は連絡用に使う
✓登録してなにか書き込もう！
✓ 明日からも使おう！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

OSS Gate？
OSSの門？
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

門
境界にあるもの
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

OSS開発者やOSSコントリ
ビューターってどんなイメー
ジ？
✓ 予想：
✓技術力が高い人
すごい人
意識が高い人
別世界の人
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

実際は
✓ OSSプロジェクトに
関わってみようと思えた人
✓ 関わってしまった人
✓ 関わるとメリットが大きい人
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

ワークショップの内容1
参加者のこと
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

進行役
✓ 進行と全体を気にかける係
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

ワークショップの内容2
流れ
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

期待
✓ 普段は気づいていないだけで
実はフィードバックポイントが
あったことを体験して！
✓※普段、ググってブログやQiitaで回
避策を探していませんか？
そんなときどうしたらよいかはワークショップ内で！
✓ フィードバックを体験して！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

ワークショップの内容3
ユーザーとして
OSSを動かす
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

対象OSS決め
✓ ビギナーが決める！
✓こちらから出す「課題」は無い
✓ サポーターは↑をサポート
✓自分の知らないOSSや言語でもよい
ビギナーと一緒に悩んであげよう！
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

対象OSS決めのヒント
✓ 使っているOSSから選ぶ
ブラウザの拡張機能・便利なコマンドラインツール等
無意識で使っている物の中にもOSSはある
✓難易度は気にしなくてよい！
サポーターがサポートするから！
✓小規模なプロジェクトや
新しめのプロジェクトは狙い目
フィードバックできる部分が多い
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

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

休憩/雑談タイム
●時▲分まで！
✓ せっかくなので色々質問してみ
よう
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

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

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

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

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

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

報告
●時▲分まで！
前半と同じサポーターに見てもらう
1. 整理する
2. 開発者にとってわかりやすく
なるように編集する
3. 適切な場所に報告する
4. ...
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

目的の確認
OSS開発未経験者
↓
OSS開発経験者
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

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

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

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

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

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

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

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

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

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

OSS Gateはメンバー募集中
✓ 次のワークショップ開催日は…
✓開催する毎に門をくぐる人がいる！
✓多くの人と協力して継続したい！
✓会場提供・サポーター・進行役・…
✓ チャットで色々話してるよ！
✓ https://gitter.im/oss-gate/${地域}
✓ 例：https://gitter.im/oss-gate/tokyo
OSS Gateワークショップオンライン版
Powered by Rabbit 3.0.2

おねがい
✓ 今日のフィードバックを！
✓次に活かしたい
✓ この後すぐ
✓アンケート記入
✓アンケート結果をみんなで確認
OSS Gateワークショップオンライン版
Powered by Rabbit 3.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 3.0.2

0 / 74