OSS Gateワークショップ
OSS Gateワークショップ

Powered by Rabbit 2.2.1

アイスブレイク✓ 目的✓ 周りの人と話しやすくなることせっかくだから相談しよう！

✓ やること✓ 参加目的をみんなに説明※内容より声を出すことが大事！
✓ まずはサポーターから発声

順番はスムーズな進行のために指定しているだけ。

OSS Gateワークショップ

Powered by Rabbit 2.2.1

チャット：Gitter✓ gitter.im/oss-gate/${地域}
例：<URL:https://gitter.im/oss-gate/tokyo>✓ オンラインで相談できる場所✓ 今日は連絡用に使う✓ 登録してなにか書き込もう！

✓ 明日からも使おう！
OSS Gateワークショップ

Powered by Rabbit 2.2.1

OSS Gate？

OSSの門？
OSS Gateワークショップ

Powered by Rabbit 2.2.1

門

境界にあるものOSS Gateワークショップ

Powered by Rabbit 2.2.1

扱う境界OSS開発活発
自信ない

未参加者

参加者
興味あり

興味なし

OSS Gateワークショップ

Powered by Rabbit 2.2.1

ターゲットOSS開発

活発自信ない

未参加者

参加者
興味あり

興味なし

OSS Gateワークショップ

Powered by Rabbit 2.2.1

やりたいこと
OSS開発

活発自信ない

未参加者

参加者
興味あり

OSS Gateワークショップ

Powered by Rabbit 2.2.1

未参加者→参加者
OSS開発

活発自信ない

未参加者

参加者
興味あり
ワークショップで実現

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

どうして未経験？
✓ （数人の参加者に聞く）✓ 予想：✓ やったことがないからなんとなく敷居が高いと感じる

OSS Gateワークショップ

Powered by Rabbit 2.2.1

ワークショップの重要事項

体験する
体験して大したことはないとわかる→敷居が下がる

OSS Gateワークショップ

Powered by Rabbit 2.2.1

体験して門をくぐる
OSS開
発

活発
自信ない

なんか不安だな…

未参加者

参加者
興味あり

OSS Gateワークショップ

くぐってしまえば別になんてことはなかった！

Powered by Rabbit 2.2.1

よりくぐりやすく
OSS開発

サポート 活発
自信ない

未参加者

参加者
興味あり

OSS Gateワークショップ

大丈夫だよー

Powered by Rabbit 2.2.1

ワークショップの内容1

参加者のことOSS Gateワークショップ

Powered by Rabbit 2.2.1

立場一覧✓ ビギナー✓ サポーター✓ サポートメンター✓ 進行役

OSS Gateワークショップ

Powered by Rabbit 2.2.1

ビギナー✓ OSSの開発に参加したい✓ でも参加したことはない✓ OSSの開発に参加した事はある✓ でもまだ自信がない

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

サポートメンター✓ サポーターのサポート係✓ サポーター経験者✓ 会場各地でスポットサポート✓ サポート例：✓ うまくサポートできていない感…
→相談しよう！
サポーター1人で完璧にサポートしなくてよい！

OSS Gateワークショップ

Powered by Rabbit 2.2.1

進行役✓ 進行と全体を気にかける係

OSS Gateワークショップ

Powered by Rabbit 2.2.1

ワークショップの内容2

流れOSS Gateワークショップ

Powered by Rabbit 2.2.1

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

OSS Gateワークショップ

Powered by Rabbit 2.2.1

流れ

1. ユーザーとしてOSSを動かす
2. ↑で気づいた事を開発元にフィードバック

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

✓ フィードバックを体験して！
OSS Gateワークショップ

Powered by Rabbit 2.2.1

ワークショップの内容3

ユーザーとしてOSSを動かす
OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

対象OSS決め✓ ビギナーが決める✓ 使っているOSSから選ぶ
ブラウザの拡張機能・便利なコマンドラインツール等
無意識で使っている物の中にもOSSはある✓ 難易度は気にしなくてよい！
サポーターがサポートするから！

✓ サポーターは↑をサポート✓ 自分の知らないOSSや言語でもよいビギナーと一緒に悩んであげよう！
OSS Gateワークショップ

Powered by Rabbit 2.2.1

対象OSS決めデモ

デモ✓ 最近使っているOSSは？
✓ ライセンス確認→OK！

✓ その中で一番ときめくのは？
✓ ではそれにしましょう！
OSS Gateワークショップ

Powered by Rabbit 2.2.1

動かすときのポイント✓ 作業メモを書く✓ 🔜メモを書く場所はこのあと作る✓ なにかする毎に書く✓ 例：ドキュメントを読み始めた✓ 例：次のドキュメントを読み始めた

OSS Gateワークショップ

Powered by Rabbit 2.2.1

作業メモを書く場所を作る

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

Powered by Rabbit 2.2.1

作業メモの例

ドキュメント通りインストールしたけど失敗した。

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

ユーザーとして動かす

デモ1. 公式サイトを開く
2. 作業メモを書く
3. 概要を読む
4. 作業メモを書く
5. ...
OSS Gateワークショップ

Powered by Rabbit 2.2.1

作業開始！

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

ふりかえり1：デモ

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

フィードバック✓ upstream（開発元）にうまくいかなかったことを報告✓ ここで詰まった、を伝える✓ こうだったらよかった、を伝える

OSS Gateワークショップ

Powered by Rabbit 2.2.1

報告方法
1. 整理する✓ 自分の考えが文章になればOK

2. 開発者にとってわかりやすくなるように編集
3. 適切な場所に報告✓ GitHubのissueとかOSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

整理方法

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

Powered by Rabbit 2.2.1

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

OSS Gateワークショップ

Powered by Rabbit 2.2.1

編集の仕方✓ ポイント✓ 相手がわかるように書く✓ 例：省略しない（具体的に書く）

OSS Gateワークショップ

Powered by Rabbit 2.2.1

省略例

インストールしました。
動きませんでした。
どうしたらいいでしょうか？

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

なぜ省略しないか✓ 相手は私を知らないから✓ 省略すると想像しないといけない✓ だいたい想像は外れる✓ 話が噛み合わない！

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

編集方法

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

Powered by Rabbit 2.2.1

3. 報告する✓ 適切な場所に報告✓ OSSによって報告場所は違う✓ サポーターへ✓ 報告に二の足を踏んでいる人の背中を押してあげて
例：自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える

OSS Gateワークショップ

Powered by Rabbit 2.2.1

報告方法

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

Powered by Rabbit 2.2.1

報告●時▲分まで！
1. 整理する
2. 開発者にとってわかりやすくなるように編集する
3. 適切な場所に報告する
4. ...
OSS Gateワークショップ

Powered by Rabbit 2.2.1

ふりかえり2：デモ

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

まとめ✓ 今日やったことを再確認✓ 明日からのことを確認

OSS Gateワークショップ

Powered by Rabbit 2.2.1

目的の確認OSS開発未経験者↓OSS開発 経験者

OSS Gateワークショップ

Powered by Rabbit 2.2.1

やったことOSS開発参加を体験する
1. ユーザーとして動かす
2. フィードバック

OSS Gateワークショップ

Powered by Rabbit 2.2.1

体験時のポイント

常にメモ
OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

OSS Gateワークショップ

Powered by Rabbit 2.2.1

詰まったところ✓ OSS開発参加のチャンス！
✓ ポジティブに捉えてみよう✓ 実際に参加して楽しかった？

✓ 直ると次の人はうまくいく✓ 気分がいいね！

OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

メッセージ

不安がらずにOSSの開発を楽しんで！
OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

Powered by Rabbit 2.2.1

OSS Gateはメンバー募集中✓ 次のワークショップ開催日は…
✓ 開催する毎に門をくぐる人がいる！
✓ 多くの人と協力して継続したい！
✓ 会場提供・サポーター・進行役・…

✓ チャットで色々話してるよ！
✓ https://gitter.im/oss-gate/${地域}✓ 例：<URL:https://gitter.im/oss-gate/tokyo>
OSS Gateワークショップ

Powered by Rabbit 2.2.1

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

OSS Gateワークショップ

Powered by Rabbit 2.2.1

アンケートの回答方法
1. github.com/oss-gate/workshop をfork
2. tutorial/retrospectives/YYYY-MM-DD-***✓ beginner.yaml → beginner-***.yaml✓ supporter.yaml → supporter-***.yaml
3. git add → git commit → git push4. github.com/自分のアカウント/workshopを開いて「Pull request」
OSS Gateワークショップ

Powered by Rabbit 2.2.1