rabbit-slide-oss-gate-workshop-tutorial 2018.9.30.0 → 2019.7.27.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 6f7f7db317c5e38dae825c5fd7bf64ea9c62a98e4af12411e10476d0a58e2856
-  data.tar.gz: 276fae7238b529a5620bae96a33fb68a34c8b06b2aa756603d125278d39fa91b
+  metadata.gz: b60afc5d8c473cecc5df69458fc9d2a3d3e6b23a0b33cf9c7b3dc1b553231ba3
+  data.tar.gz: dc1c7ce1cf4cb41318fbfdfecf67896b034287f1f463a5b67d42f07aec9a2170
 SHA512:
-  metadata.gz: 87ef709d0aafec6e7b34680d8f18e3fcfb12374071899e17f4532b12ef33cbb73ffcf4fa567c195d0adf7d85a9eb2fede5a8b959f0376d9068183febb416576f
-  data.tar.gz: fb29a13fcb0860f4b7e883bed9bf5fcd5537ea3a41dc8d57b4c217b4c35c52f80b4a41f5daa2ccf1f1de941726722aba36f34c1f4cc0f6875306a48b9fa6863d
+  metadata.gz: 8e3557802ff890ae907bdb56ce94f06b1061ff197c0944fad95239dc07ce414d4b5dbed46c646045cb0d11d816712e738f12de33784687e16e975e44cf7574a8
+  data.tar.gz: '0996ac852482ebf3a3a34c3a3838657b783595188cf482d375260f3b30abfabc7ca9885b230740f1e6dc230bec2174cc977984008c3dc7463f59567cace914e3'

data/config.yaml

@@ -5,8 +5,8 @@ tags:
 - rabbit
 - oss_gate
 - workshop
-presentation_date: 2018-09-30
-version: 2018.9.30.0
+presentation_date: 2019-07-27
+version: 2019.7.27.0
 licenses:
 - CC BY-SA 4.0
 slideshare_id: 

data/scenario-short.rab

@@ -0,0 +1,548 @@
+= OSS Gate\nワークショップ\n短縮版
+
+: theme
+   clear-blue
+
+= アイスブレイク
+
+  * 目的
+    * 周りの人と話しやすくなること\n
+      (('note:せっかくだから相談しよう！'))
+  * やること
+    * 参加目的をみんなに説明\n
+      ※内容より((*声を出すことが大事！*))
+    * まずはサポーターから発声\n
+      (('note:順番はスムーズな進行のために指定しているだけ。'))
+
+= タイムテーブル
+
+ * (90分) 前半/実際に動かしてみる
+ * (10分) 休憩
+ * (50分) 後半/報告する内容をまとめる
+ * (50分) 後半/実際に報告してみる
+ * (10分) まとめ
+ * (50分) アンケート回答・結果回覧
+
+= チャット：Gitter
+
+  * gitter.im/oss-gate/(({${地域}}))\n
+    (('note:例：((<URL:https://gitter.im/oss-gate/tokyo>))'))
+  * オンラインで相談できる場所
+  * 今日は連絡用に使う
+    * 登録してなにか書き込もう！
+  * 明日からも使おう！
+
+= OSS Gate？
+
+  # image
+  # src = images/oss-gate-icon.svg
+  # relative_width = 30
+  # align = right
+  # vertical_align = top
+  # relative_margin_right = 23
+
+(('tag:center'))
+(('tag:x-large'))
+OSSの門？
+
+= 門
+
+(('tag:center'))
+(('tag:x-large'))
+境界にあるもの
+
+= 扱う境界
+
+  # image
+  # src = images/oss-gate-border.svg
+  # relative_width = 100
+
+= ターゲット
+
+  # image
+  # src = images/oss-gate-target.svg
+  # relative_width = 100
+
+= やりたいこと
+
+  # image
+  # src = images/oss-gate-goal.svg
+  # relative_width = 100
+
+= 未参加者→参加者
+
+  # image
+  # src = images/oss-gate-workshop.svg
+  # relative_width = 100
+
+= OSS Gateとワークショップ
+
+  * (('wait'))OSS Gate
+    * [OSS開発参加者を継続的に増やす]\n
+      取り組み
+  * (('wait'))OSS Gateワークショップ
+    * […増やす]を実現するための1手段
+    * ((*未*))経験者が経験者になると増える
+
+= どうして((*未*))経験？
+
+  * （数人の参加者に聞く）
+  * 予想：
+    * (('wait'))やったことがないから\n
+      なんとなく敷居が高いと感じる
+
+= ワークショップの重要事項
+
+(('tag:center'))
+(('tag:x-large'))
+体験する\n
+(('note:体験して大したことはないとわかる→敷居が下がる'))
+
+= 体験して門をくぐる
+
+  # image
+  # src = images/oss-gate-pass-through.svg
+  # relative_width = 100
+
+= よりくぐりやすく
+
+  # image
+  # src = images/oss-gate-support.svg
+  # relative_width = 100
+
+= ワークショップの内容1
+
+(('tag:center'))
+(('tag:x-large'))
+参加者のこと
+
+= 立場一覧
+
+  * ビギナー
+  * サポーター
+  * サポートメンター
+  * 進行役
+
+= ビギナー
+
+  * OSSの開発に参加したい
+    * でも参加したことはない
+  * OSSの開発に参加した事はある
+    * でもまだ自信がない
+
+= サポーター
+
+  * ビギナーのサポート係
+  * OSS開発経験者
+  * 初参加でも大丈夫！
+    * 例：進行役がやることを随時説明
+    * 例：サポートメンターがサポート
+  * 駄目出し係ではなく、
+    ((*よかったことをよい！と言いましょう*))
+
+= サポートメンター
+
+  * サポーターのサポート係
+  * サポーター経験者
+  * 会場各地でスポットサポート
+  * サポート例：
+    * うまくサポートできていない感…\n
+      →相談しよう！\n
+      (('note:サポーター1人で完璧にサポートしなくてよい！'))
+
+= 進行役
+
+  * 進行と全体を気にかける係
+
+= ワークショップの内容2
+
+(('tag:center'))
+(('tag:x-large'))
+流れ
+
+= 今日の流れのポイント
+
+  * 未経験者の最初の1歩に最適化
+    * ※OSSの開発方法はいろいろある
+    * ※やりたい事がある人は応相談
+    * ※基本的にこのやり方でやろう！
+
+= 流れ
+
+  (1) ((*ユーザーとして*))OSSを動かす
+  (2) ↑で気づいた事を開発元に\n
+      ((*フィードバック*))
+
+= 期待
+
+  * 普段は気づいていないだけで\n
+    実はフィードバックポイントが\n
+    あったことを((*体験*))して！
+    * ※普段、ググってブログやQiitaで回避策を探していませんか？\n
+      (('note:そんなときどうしたらよいかはワークショップ内で！'))
+  * フィードバックを((*体験*))して！
+
+= ワークショップの内容3
+
+(('tag:center'))
+(('tag:x-large'))
+ユーザーとして\n
+OSSを動かす
+
+= 動かす流れ
+
+(('tag:center'))
+(('note:（詳細は後述）'))
+
+  (1) 対象OSSを決める
+  (2) 作業メモを書く場所を用意
+  (3) 作業メモを書きながら\n
+      ((*公式サイト・README通り*))\n
+      動かす
+
+= OSSとは
+
+  * オープンソースライセンスを\n
+    設定したソフトウェア
+    * ((<URL:https://opensource.org/licenses/alphabetical>))
+  * ライセンスを確認すれば\n
+    OSSかどうかわかる
+    * OSS「っぽい」は存在しない
+
+= 対象OSS決め
+
+  * ビギナーが決める
+    * 使っているOSSから選ぶ\n
+      (('note:ブラウザの拡張機能・便利なコマンドラインツール等'))\n
+      (('note:無意識で使っている物の中にもOSSはある'))
+    * 難易度は気にしなくてよい！\n
+      (('note:サポーターがサポートするから！'))
+  * サポーターは↑をサポート
+    * 自分の知らないOSSや言語でもよい\n
+      (('note:ビギナーと一緒に悩んであげよう！'))
+
+= 対象OSS決めデモ
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * 最近使っているOSSは？
+    * ライセンス確認→OK！
+  * その中で一番ときめくのは？
+  * ではそれにしましょう！
+
+= 動かすときのポイント
+
+  * 作業メモを書く
+    * 🔜メモを書く場所はこのあと作る
+  * なにかする毎に書く
+    * 例：ドキュメントを読み始めた
+    * 例：次のドキュメントを読み始めた
+
+= 作業メモを書く場所を作る
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  (1) GitHub: oss-gate/workshop
+  (2) ↑にissueを作る
+  (3) サポーターがissueにコメント
+
+= ユーザーとして動かす
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  (1) 公式サイトを開く
+  (2) 作業メモを書く
+  (3) 概要を読む
+  (4) 作業メモを書く
+  (5) ...
+
+
+= 作業メモの例
+
+  ドキュメント通りインストールしたけど
+  失敗した。
+
+= よりよい作業メモの例
+
+  http://... のインストール手順をなぞろう！
+  （↑後から再度参照できるようにURLも書く）
+  brewでインストールできるはずなのに失敗した
+  （↑期待する結果）
+
+    % brew install XXX（←なにをしたか）
+    （...コマンドの実行結果...）
+    （↑実際の結果）
+    XXX is not found
+  ↑というようにパッケージがないと言われる
+
+= 作業開始！
+
+(('tag:center'))
+(('tag:x-large'))
+●時▲分まで！
+
+  (1) 公式サイトを開く
+  (2) 作業メモを書く
+  (3) 概要を読む
+  (4) 作業メモを書く
+  (5) ...
+
+= 休憩
+
+(('tag:center'))
+(('tag:x-large'))
+●時▲分まで！
+
+= 現状確認
+
+  (1) (('del:ユーザーとして動かす'))
+  (2) (('del:フィードバックポイントを'))\n
+      (('del:発見！'))
+  (3) (('wait'))↑を((*フィードバック*))
+
+= フィードバック
+
+  * upstream（開発元）に\n
+    うまくいかなかったことを報告
+    * ここで詰まった、を伝える
+    * こうだったらよかった、を伝える
+
+= 報告方法
+
+  (1) 整理する
+      * 自分の考えが文章になればOK
+  (2) (('wait'))((*開発者にとって*))\n
+      わかりやすくなるように編集
+  (3) (('wait'))適切な場所に報告
+      * GitHubのissueとか
+
+= 1. 整理する
+
+  * 自分で自分の気持ちを理解
+    * 自分が読んで理解できる文章に\n
+      まとめられれば理解できている
+    * 自分が理解できていないことは\n
+      開発者にも伝えられない！
+    * 作業メモに追記→サポーター確認
+
+(('note:サポーターへ：メモ（断片）の文書化を手伝って'))\n
+(('note:例：考えを整理できるような質問をする'))
+
+= 整理方法
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * 作業メモを開く
+  * フィードバック対象を決める
+  * 自分の気持ちを作業メモに追記
+  * サポーターに確認依頼
+
+= 2. 編集する
+
+  * ((*開発者にとって*))\n
+    わかりやすくなるように編集
+    * 報告方針をまとめているOSSもある\n
+      (('note:例：GitHubにあるCONTRIBUTING.md'))
+    * 作業メモに追記→サポーターに確認
+
+(('note:サポーターへ：リーダブル化を手伝って'))\n
+(('note:例：自分が開発者ならこう読めると開発者視点を伝える'))\n
+
+= 編集の仕方
+
+  * ポイント
+    * ((*相手が*))わかるように書く
+    * 例：省略しない（具体的に書く）
+
+= 省略例
+
+  # blockquote
+
+  インストールしました。
+
+  動きませんでした。
+
+  どうしたらいいでしょうか？
+
+= 省略しない例
+
+  # blockquote
+
+  ↓でインストール
+
+    % sudo apt-get install ...
+    （...実行結果...）
+
+  ↑のように失敗しました。
+
+  環境：Ubuntu 16.10 amd64
+
+= なぜ省略しないか
+
+  * 相手は私を知らないから
+    * 省略すると((*想像*))しないといけない
+    * だいたい((*想像は外れる*))
+    * 話が噛み合わない！
+
+= 省略しないとは
+
+  * 詳細を書く
+    * 実行したコマンド・実行結果
+  * やったことを書く
+  * ((*やっていないこと*))を書く
+  * 期待した結果を書く
+
+= 編集方法
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * 作業メモを開く
+  * 自分の気持ちを開発者に伝わるようにまとめて作業メモに追記
+  * サポーターに確認依頼
+
+= 3. 報告する
+
+  * 適切な場所に報告
+    * OSSによって報告場所は違う
+  * サポーターへ
+    * 報告に二の足を踏んでいる人の背中を押してあげて\n
+      (('note:例：自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える'))
+
+= 報告方法
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * 報告方法を探す
+  * サポーターに後押ししてもらう
+  * まとめた報告内容を報告
+
+= まとめ
+
+  * 今日やったことを再確認
+  * 明日からのことを確認
+
+= 目的の確認
+
+(('tag:center'))
+(('tag:large'))
+OSS開発((*未*))経験者\n
+↓\n
+OSS開発　経験者
+
+= やったこと
+
+(('tag:center'))
+(('tag:large'))
+OSS開発参加を体験する
+
+  (1) ユーザーとして動かす
+  (2) フィードバック
+
+= 体験時のポイント
+
+(('tag:center'))
+(('tag:x-large'))
+常にメモ
+
+= 常にメモの理由
+
+  * 詰まったところに気づくため
+    * いつもはスルーしていない？
+    * 実はフィードバックポイント！
+
+= 詰まったところ
+
+  * OSS開発参加の((*チャンス*))！
+    * ポジティブに捉えてみよう
+    * 実際に参加して楽しかった？
+  * 直ると次の人は((*うまくいく*))
+    * 気分がいいね！
+
+= 気づいた？
+
+  * コードを書くだけが\n
+    OSS開発参加方法じゃない
+    * 使いはじめのユーザーだから\n
+      できることもある
+  * やり方を知ればやれる
+    * 明日からもやってみよう！
+
+= 明日からのやり方
+
+  * 自分が使っているOSSでも\n
+    やってみよう
+    (1) ユーザーとして動かす
+    (2) 気になったことをまとめる
+    (3) フィードバック
+  * (('wait'))↑失敗が怖い？
+
+= OSSと失敗
+
+  * そもそも失敗と認識されない
+    * 少なくとも1発アウト！はほぼない
+    * 新規開発者は基本的にWelcome
+  * 失敗しても根に持たれない
+    * 失敗→改善：改善後を評価
+
+(('wait'))
+(('tag:center'))
+↓\n
+明日からオススメ方法をTry！
+
+= メッセージ
+
+(('tag:center'))
+(('tag:x-large'))
+不安がらずに\n
+OSSの開発を\n
+楽しんで！
+
+= 来てよかった！と思ったら
+
+  * OSS Gateに継続参加！
+    * チャット・ワークショップ・…
+    * 社内・コミュニティ向け\n
+      ワークショップを検討
+  * OSS Gateを継続宣伝！
+    * 周りの人を誘う
+    * ブログに書く
+
+= OSS Gateはメンバー募集中
+
+  * 次のワークショップ開催日は…
+    * 開催する毎に門をくぐる人がいる！
+    * 多くの人と協力して継続したい！
+    * 会場提供・サポーター・進行役・…
+  * チャットで色々話してるよ！
+    * (('tag:x-small'))https://gitter.im/oss-gate/(({${地域}}))
+    * (('tag:x-small'))例：((<URL:https://gitter.im/oss-gate/tokyo>))
+
+= おねがい
+
+  * 今日のフィードバックを！
+    * 次に活かしたい
+  * この後すぐ
+    * アンケート記入
+    * アンケート結果をみんなで確認
+
+= アンケートの回答方法
+
+  (1) (('tag:x-small'))github.com/oss-gate/workshop をfork
+  (2) (('tag:x-small'))tutorial/retrospectives/YYYY-MM-DD-***
+      * (('tag:x-small'))beginner.yaml → beginner-***.yaml
+      * (('tag:x-small'))supporter.yaml → supporter-***.yaml
+  (3) (('tag:x-small'))git add → git commit → git push
+  (4) (('tag:x-small'))github.com/自分のアカウント/workshop
+      を開いて「Pull request」

data/scenario.rab

@@ -452,6 +452,17 @@ OSSを動かす
   * サポーターに後押ししてもらう
   * まとめた報告内容を報告
 
+= 報告
+
+(('tag:center'))
+(('tag:x-large'))
+●時▲分まで！
+
+  (1) 整理する
+  (2) 開発者にとってわかりやすくなるように編集する
+  (3) 適切な場所に報告する
+  (4) ...
+
 = ふりかえり2：デモ
 
 (('tag:center'))
@@ -582,3 +593,13 @@ OSSの開発を\n
   * この後すぐ
     * アンケート記入
     * アンケート結果をみんなで確認
+
+= アンケートの回答方法
+
+  (1) (('tag:x-small'))github.com/oss-gate/workshop をfork
+  (2) (('tag:x-small'))tutorial/retrospectives/YYYY-MM-DD-***
+      * (('tag:x-small'))beginner.yaml → beginner-***.yaml
+      * (('tag:x-small'))supporter.yaml → supporter-***.yaml
+  (3) (('tag:x-small'))git add → git commit → git push
+  (4) (('tag:x-small'))github.com/自分のアカウント/workshop
+      を開いて「Pull request」

metadata

@@ -1,14 +1,14 @@
 --- !ruby/object:Gem::Specification
 name: rabbit-slide-oss-gate-workshop-tutorial
 version: !ruby/object:Gem::Version
-  version: 2018.9.30.0
+  version: 2019.7.27.0
 platform: ruby
 authors:
 - OSS Gate
 autorequire: 
 bindir: bin
 cert_chain: []
-date: 2018-09-30 00:00:00.000000000 Z
+date: 2019-07-27 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rabbit
@@ -51,6 +51,7 @@ files:
 - images/oss-gate-target.svg
 - images/oss-gate-workshop.svg
 - pdf/workshop-tutorial-scenario.pdf
+- scenario-short.rab
 - scenario.md
 - scenario.rab
 homepage: http://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial/
@@ -72,8 +73,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubyforge_project: 
-rubygems_version: 3.0.0.beta1
+rubygems_version: 3.0.3
 signing_key: 
 specification_version: 4
 summary: OSS Gateワークショップ（チュートリアル）