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

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: b60afc5d8c473cecc5df69458fc9d2a3d3e6b23a0b33cf9c7b3dc1b553231ba3
-  data.tar.gz: dc1c7ce1cf4cb41318fbfdfecf67896b034287f1f463a5b67d42f07aec9a2170
+  metadata.gz: 05f3bc07c93b6b73dcfc6e266ea44bf94df379fdb0fd9ae31b19a61432b16430
+  data.tar.gz: c3f89c3e43cdb88d62f9fdfdc12de3c3632e921de1cecbc96fd473266bfa054a
 SHA512:
-  metadata.gz: 8e3557802ff890ae907bdb56ce94f06b1061ff197c0944fad95239dc07ce414d4b5dbed46c646045cb0d11d816712e738f12de33784687e16e975e44cf7574a8
-  data.tar.gz: '0996ac852482ebf3a3a34c3a3838657b783595188cf482d375260f3b30abfabc7ca9885b230740f1e6dc230bec2174cc977984008c3dc7463f59567cace914e3'
+  metadata.gz: 704a665ce034e5de045a6c0d22482968478f1366d3f5a12afea8f6b3c176f283d572af48fc6484796ba39dc1d1851aaea3ed31e6eae6cfb92a6941afbab374df
+  data.tar.gz: d21f0584a2a00897d3a5c45e9b19c4597adc0a8df8160e8fb340a021cb8b93d439eff36b085f0b0da81898e052187c30262f80cf0671aef09f9054c66f7fb0d7

data/.rabbit

@@ -1 +1,2 @@
+--size 1280,720
 scenario.rab

data/README.md

@@ -1,8 +1,8 @@
-# OSS Gateワークショップ（チュートリアル）
+# OSS Gateワークショップ（チュートリアル）オフライン版
 
-OSS Gateワークショップ（チュートリアル）の説明。
+OSS Gateワークショップ（チュートリアル）オフライン版の説明。
 
-スライドと[文章](scenario.md)があります。説明をするときはスライド、詳細を確認するときは文章が適しています。スライドは使い方にあわせて次のどれかを使います。
+スライドと[文章](../scenario.md)があります。説明をするときはスライド、詳細を確認するときは文章が適しています。スライドは使い方にあわせて次のどれかを使います。
 
   * [ソース](scenario.rab)：ローカルで[Rabbit](http://rabbit-shocker.org/)を使って表示するとき
   * [Rabbit Slide Show](https://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial/)：Webブラウザーで表示するとき（Rabbitを用意する必要はない）
@@ -16,7 +16,7 @@ OSS Gateワークショップ（チュートリアル）の説明。
 
 CC BY-SA 4.0
 
-詳細は[LICENSE](LICENSE)を確認してください。
+詳細は[LICENSE](../LICENSE)を確認してください。
 
 ## スライド
 

data/Rakefile

@@ -2,13 +2,23 @@ require "rabbit/task/slide"
 
 # Edit ./config.yaml to customize meta data
 
+Dir.glob("../{LICENSE,images/**/*.*}") do |shared_file|
+  relative_path = shared_file.gsub(/\A\.\.\//, "")
+  file relative_path => shared_file do
+    mkdir_p(File.dirname(relative_path))
+    cp(shared_file, relative_path)
+  end
+end
+
 spec = nil
 Rabbit::Task::Slide.new do |task|
   spec = task.spec
-  task.spec.files += ["LICENSE", "scenario.md"]
-  task.spec.files += Dir.glob("images/**/*.*")
+  task.spec.files += ["LICENSE"]
+  task.spec.files += Dir.glob("../images/**/*.*").collect do |path|
+    path.gsub(/\A\.\.\//, "")
+  end
   # task.spec.files -= Dir.glob("private/**/*.*")
-  # task.spec.add_runtime_dependency("rabbit-theme-clear-code")
+  task.spec.add_runtime_dependency("rabbit-theme-clear-code")
 end
 
 desc "Tag #{spec.version}"

data/config.yaml

@@ -5,15 +5,16 @@ tags:
 - rabbit
 - oss_gate
 - workshop
-presentation_date: 2019-07-27
-version: 2019.7.27.0
+presentation_date: 2026-02-13
+version: 2026.2.13.0
 licenses:
-- CC BY-SA 4.0
+- CC-BY-SA-4.0
 slideshare_id: 
 speaker_deck_id: 
 ustream_id: 
 vimeo_id: 
 youtube_id: 
+source_code_uri: https://github.com/oss-gate/workshop/tree/master/tutorial/scenario
 author:
   markup_language: :rd
   name: OSS Gate

data/scenario.rab

@@ -1,7 +1,7 @@
 = OSS Gate\nワークショップ
 
 : theme
-   clear-blue
+   .
 
 = アイスブレイク
 
@@ -14,23 +14,23 @@
     * まずはサポーターから発声\n
       (('note:順番はスムーズな進行のために指定しているだけ。'))
 
-= チャット：Gitter
+= チャット：Element
 
-  * gitter.im/oss-gate/(({${地域}}))\n
-    (('note:例：((<URL:https://gitter.im/oss-gate/tokyo>))'))
-  * オンラインで相談できる場所
-  * 今日は連絡用に使う
-    * 登録してなにか書き込もう！
-  * 明日からも使おう！
+  * (('tag:x-small'))
+    ((<URL:https://app.element.io/#/room/#oss-gate:matrix.org>))
+    * アナウンス：(({oss-gate/announce}))
+  * 今後もみんなとつながっていたい！
+  * まず登録して挨拶しよう！
+  * 終わったら今日の成果を自慢しよう！
 
 = OSS Gate？
 
   # image
-  # src = images/oss-gate-icon.svg
-  # relative_width = 30
+  # src = ../images/oss-gate-icon.svg
+  # relative_width = 25
   # align = right
   # vertical_align = top
-  # relative_margin_right = 23
+  # relative_margin_right = 32
 
 (('tag:center'))
 (('tag:x-large'))
@@ -45,26 +45,26 @@ OSSの門？
 = 扱う境界
 
   # image
-  # src = images/oss-gate-border.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-border.svg
+  # relative_height = 100
 
 = ターゲット
 
   # image
-  # src = images/oss-gate-target.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-target.svg
+  # relative_height = 100
 
 = やりたいこと
 
   # image
-  # src = images/oss-gate-goal.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-goal.svg
+  # relative_height = 100
 
 = 未参加者→参加者
 
   # image
-  # src = images/oss-gate-workshop.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-workshop.svg
+  # relative_height = 100
 
 = OSS Gateとワークショップ
 
@@ -92,14 +92,14 @@ OSSの門？
 = 体験して門をくぐる
 
   # image
-  # src = images/oss-gate-pass-through.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-pass-through.svg
+  # relative_height = 100
 
 = よりくぐりやすく
 
   # image
-  # src = images/oss-gate-support.svg
-  # relative_width = 100
+  # src = ../images/oss-gate-support.svg
+  # relative_height = 100
 
 = ワークショップの内容1
 
@@ -167,7 +167,7 @@ OSSの門？
   * 普段は気づいていないだけで\n
     実はフィードバックポイントが\n
     あったことを((*体験*))して！
-    * ※普段、ググってブログやQiitaで回避策を探していませんか？\n
+    * ※ググったり生成AIに聞いて回避していない？\n
       (('note:そんなときどうしたらよいかはワークショップ内で！'))
   * フィードバックを((*体験*))して！
 
@@ -193,7 +193,7 @@ OSSを動かす
 
   * オープンソースライセンスを\n
     設定したソフトウェア
-    * ((<URL:https://opensource.org/licenses/alphabetical>))
+    * ((<URL:https://opensource.org/licenses/>))
   * ライセンスを確認すれば\n
     OSSかどうかわかる
     * OSS「っぽい」は存在しない
@@ -247,12 +247,12 @@ OSSを動かす
 
 = よりよい作業メモの例
 
-  http://... のインストール手順をなぞろう！
+  https://... のインストール手順をなぞろう！
   （↑後から再度参照できるようにURLも書く）
   brewでインストールできるはずなのに失敗した
   （↑期待する結果）
 
-    % brew install XXX（←なにをしたか）
+    $ brew install XXX（←なにをしたか）
     （...コマンドの実行結果...）
     （↑実際の結果）
     XXX is not found
@@ -402,12 +402,12 @@ OSSを動かす
 
   ↓でインストール
 
-    % sudo apt-get install ...
+    $ sudo apt install ...
     （...実行結果...）
 
   ↑のように失敗しました。
 
-  環境：Ubuntu 16.10 amd64
+  環境：Ubuntu 24.04 amd64
 
 = なぜ省略しないか
 
@@ -431,7 +431,8 @@ OSSを動かす
 デモ
 
   * 作業メモを開く
-  * 自分の気持ちを開発者に伝わるようにまとめて作業メモに追記
+  * 自分の気持ちを開発者に伝わるように\n
+    まとめて作業メモに追記
   * サポーターに確認依頼
 
 = 3. 報告する
@@ -439,8 +440,9 @@ OSSを動かす
   * 適切な場所に報告
     * OSSによって報告場所は違う
   * サポーターへ
-    * 報告に二の足を踏んでいる人の背中を押してあげて\n
-      (('note:例：自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える'))
+    * 報告に二の足を踏んでいる人の\n
+      背中を押してあげて\n
+      (('note:例：開発者視点を伝える：自分ならこの報告をもらったら助かる'))
 
 = 報告方法
 
@@ -461,7 +463,9 @@ OSSを動かす
   (1) 整理する
   (2) 開発者にとってわかりやすくなるように編集する
   (3) 適切な場所に報告する
-  (4) ...
+  (4) 報告したことをチャットで自慢！\n
+      * (('tag:x-small'))
+        ((<URL:https://app.element.io/#/room/#oss-gate:matrix.org>))
 
 = ふりかえり2：デモ
 
@@ -485,6 +489,66 @@ OSSを動かす
   * 時間が余ったら：
     * 近くの他のビギナーにも説明
 
+= OSS開発関連情報
+
+  * 生成AI
+
+= 生成AIとOSS開発
+
+  * OSS開発にも生成AIは使われ始めている
+  * よい付き合い方はまだ探り探り
+  * これは困るというのは見えてきている
+  * ポイント：\n
+    自分も開発チームの1人という振る舞い
+
+= 生成AIで報告
+
+  * 生成された報告は冗長なことが多い
+    * 無用な冗長さは開発者を疲弊させる
+    * 開発チームの1人としてどうしたい？
+  * 必須：報告前に報告者がレビュー！
+    * 報告者がそもそも理解できていること
+      * 開発者に聞かれたら自分で答えられるくらい
+    * 報告者が不要な情報を減らす
+
+= 生成AIでプルリクエスト
+
+  * 大きなプルリクエストになりがち
+    * 大きなプルリクエストは開発者を疲弊させる
+    * 開発チームの1人としてどうしたい？
+  * 必須：作成前に作成者がレビュー！
+    * 詳細を理解する
+    * レビュー可能なサイズにする
+
+= プルリクエストとレビュー
+
+  * 狙いの1つ：関係者間での知識の共有
+    * 作成者が未理解→知識の共有は進まない
+    * 作成者抜きで開発者が直接生成AIを使えばよい
+  * 開発チームの1人としてどうしたい？
+    * 学んで次のプルリクエストに活かせる？
+    * 学んだことを他の人に伝えられる？
+
+= 生成AIとライセンス
+
+  * 機械が生成したものに著作権は発生しない
+  * 著作権があるコードの複製を生成しうる
+    * そのコードのライセンスが大事
+    * ライセンスを守れれば再利用可能
+  * ライセンスの問題がないことは\n
+    プルリクエスト作成者が保証する
+
+= 生成AIとコミット
+
+  * どのツールを使ったかの情報を残す
+    * Gitなら(({Generated-By: ...}))などで記録
+    * なにか問題があったときに調べられるように
+
+= 生成AIとOSS開発
+
+  * 生成したものを丸投げはダメ
+  * 生成したものを詳細まで理解した上で活用
+
 = まとめ
 
   * 今日やったことを再確認
@@ -570,8 +634,7 @@ OSSの開発を\n
 
   * OSS Gateに継続参加！
     * チャット・ワークショップ・…
-    * 社内・コミュニティ向け\n
-      ワークショップを検討
+    * 社内・コミュニティ向けワークショップを検討
   * OSS Gateを継続宣伝！
     * 周りの人を誘う
     * ブログに書く
@@ -582,9 +645,10 @@ OSSの開発を\n
     * 開催する毎に門をくぐる人がいる！
     * 多くの人と協力して継続したい！
     * 会場提供・サポーター・進行役・…
-  * チャットで色々話してるよ！
-    * (('tag:x-small'))https://gitter.im/oss-gate/(({${地域}}))
-    * (('tag:x-small'))例：((<URL:https://gitter.im/oss-gate/tokyo>))
+  * 次回の開催日をチェック！
+    * (('tag:x-small'))
+      ((<URL:https://app.element.io/#/room/#oss-gate:matrix.org>))
+    * (('tag:x-small'))アナウンス：(({oss-gate/announce}))
 
 = おねがい
 
@@ -598,8 +662,8 @@ 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
+      * cp (('tag:x-small'))beginner.yaml beginner-***.yaml
+      * cp (('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/theme.rb

@@ -0,0 +1,5 @@
+@font_family = find_font_family("モトヤLマルベリ3等幅") ||
+  find_font_family("モトヤLマルベリ") ||
+  find_font_family("MotoyaLMaru") ||
+  @font_family
+include_theme("clear-blue")

metadata

@@ -1,14 +1,13 @@
 --- !ruby/object:Gem::Specification
 name: rabbit-slide-oss-gate-workshop-tutorial
 version: !ruby/object:Gem::Version
-  version: 2019.7.27.0
+  version: 2026.2.13.0
 platform: ruby
 authors:
 - OSS Gate
-autorequire: 
 bindir: bin
 cert_chain: []
-date: 2019-07-27 00:00:00.000000000 Z
+date: 2026-02-13 00:00:00.000000000 Z
 dependencies:
 - !ruby/object:Gem::Dependency
   name: rabbit
@@ -24,10 +23,24 @@ dependencies:
     - - ">="
       - !ruby/object:Gem::Version
         version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: rabbit-theme-clear-code
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
 description: |-
-  OSS Gateワークショップ（チュートリアル）の説明。
+  OSS Gateワークショップ（チュートリアル）オフライン版の説明。
 
-  スライドと[文章](scenario.md)があります。説明をするときはスライド、詳細を確認するときは文章が適しています。スライドは使い方にあわせて次のどれかを使います。
+  スライドと[文章](../scenario.md)があります。説明をするときはスライド、詳細を確認するときは文章が適しています。スライドは使い方にあわせて次のどれかを使います。
 
     * [ソース](scenario.rab)：ローカルで[Rabbit](http://rabbit-shocker.org/)を使って表示するとき
     * [Rabbit Slide Show](https://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial/)：Webブラウザーで表示するとき（Rabbitを用意する必要はない）
@@ -49,16 +62,17 @@ files:
 - images/oss-gate-pass-through.svg
 - images/oss-gate-support.svg
 - images/oss-gate-target.svg
+- images/oss-gate-watch.png
 - 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/
+- theme.rb
+homepage: https://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial/
 licenses:
-- CC BY-SA 4.0
-metadata: {}
-post_install_message: 
+- CC-BY-SA-4.0
+metadata:
+  source_code_uri: https://github.com/oss-gate/workshop/tree/master/tutorial/scenario
+  markup_language: rd
 rdoc_options: []
 require_paths:
 - lib
@@ -73,8 +87,7 @@ required_rubygems_version: !ruby/object:Gem::Requirement
     - !ruby/object:Gem::Version
       version: '0'
 requirements: []
-rubygems_version: 3.0.3
-signing_key: 
+rubygems_version: 4.1.0.dev
 specification_version: 4
-summary: OSS Gateワークショップ（チュートリアル）
+summary: OSS Gateワークショップ（チュートリアル）オフライン版
 test_files: []

data/scenario-short.rab

@@ -1,548 +0,0 @@
-= 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.md

@@ -1,262 +0,0 @@
-# シナリオ
-
-## 用語集
-
-はじめにこのワークショップで使う用語を説明します。
-
-  * 進行役：ワークショップを進行する役割の人（すでにOSSの開発に参加している人）
-    * 1人
-  * ビギナー：OSSの開発に参加したいけどまだ参加したことがない人・参加したことはあるけどまだ自信がない人
-    * 複数人
-  * サポーター：ビギナーをサポートする役割の人（すでにOSSの開発に参加している人）
-    * 複数人
-  * サポートメンター：サポーターをサポートする役割の人（すでにサポーターの経験がある人）
-    * 複数人
-
-## 目的
-
-「OSS Gateワークショップ」の目的は「OSS開発に参加する最初の一歩を支援すること」です。
-
-## 対象
-
-  * OSSの開発に参加したいけどまだ参加したことがない人
-  * OSSの開発に参加したことはあるけどまだ自信がない人
-
-## 目的の実現方法
-
-OSSの開発に参加したいけどまだ参加したことがない人が参加していない理由は「漠然とした不安がある」からです。このワークショップでは「不安」を解消することによりOSS開発に参加する最初の一歩を支援します。
-
-「不安」の原因は次の通りです。
-
-  * 「やり方」を知らないから
-  * やったことがないから
-
-これらの「不安」の原因を解決するために次のことを実施します。
-
-  * 「やり方」を伝える
-  * 「やり方」を実際にやってみる
-
-具体的には次の方法を実施して「不安」を取りのぞきます。
-
-  * オススメのOSS開発参加方法を紹介
-  * オススメの方法を実践
-
-OSSの開発に参加する方法は無数にありますが、「好きなようにやっていいんだよ」と言うと不安を増す原因になってしまいます。「好きなように」と言われてもそもそもどのような「やり方」を選べるかもわからないからです。
-
-このワークショップでは、OSS Gateがオススメする方法を「1つだけ」説明し、実際にビギナーが「やってみます」。あえて1つに限定することにより迷いポイントが減り、不安を軽減できるからです。
-
-ビギナーがオススメの方法を試すとき、「こんなissueを立てて嫌がられないかな…」と「不安」にならないよう、サポーターがその場で「それをやっても大丈夫だよ、やってみよう！」と声をかけます。サポーターに大丈夫だと言ってもらえたら、その「不安」を取りのぞけるからです。
-
-## 目的達成の評価方法
-
-ワークショップ後、自分1人でもOSSの開発に参加できる「気がするか」どうかを判断基準とします。「気がする」なら、OSS開発への心理的敷居は十分に下がっていて、OSS開発参加への具体的なとっかかり方法が身についた、と判断します。
-
-## 大事にしたいこと
-
-ビギナー：
-
-  * 実際にやってみる！（経験すれば多くの不安は解消するはず！）
-  * 楽しむ！（経験すれば楽しいことがわかるはず！）
-
-サポーターの人の動き方の方針：
-
-  * 答えを教えない（開発に使う言語・開発対象のOSSが多様なので知らないことも多いはず）
-    * 代わりに一緒にやる。自分のPCでも並行して作業してわかったら教える、ではなく、ビギナーのPCで一緒に作業ということ。そのとき、自分がどうして次にこう行動をしようとしているのかの理由を伝えながら一緒に作業する。
-  * 自分ならこういうときにどう考えてどう行動するかを伝える
-  * 自分がフィードバックを受ける側ならこう受け取る、ということを伝える
-
-サポートメンターの人の動き方の方針：
-
-  * サポーターが処理しきれないことをフォローする。
-    * 同時に複数のビギナーからサポートを求められているサポーターがいたら、1人のサポートを引き取る。
-    * サポーターが目的を見失っていそう（サポーターがビギナーに教えているとかはビギナーが体験する機会を奪っている！ので目的に沿っていない）なら目的を思い出せるようにフォローする。
-
-## 当日までの準備
-
-  * 会場の準備
-    * 6人ぐらいが囲んで座れる場所を、いくつか用意できる会場がやりやすい
-    * 説明用のプロジェクタは欲しい
-    * ネットワークは必須
-    * 参加者全員のPCのコンセントが繋がる必要
-  * 参加者募集
-    * 募集は今は[Doorkeeper](https://oss-gate.doorkeeper.jp/)で募集している。
-  * 進行役はこのsenario.mdや[スライド](https://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial/)（[ソース](scenario.rab)）をあらかじめ確認しておく
-  * 最後のふりかえりのためのアンケートを準備しておく
-
-## 開催当日の開始前
-
-  * ビギナーはネットワークの設定をすること
-  * サポーターはネットワークの設定をすること
-  * サポートメンターを決める
-    * サポーターの中からOSS Gateの参加経験の多い人
-
-## 10:30 アイスブレイク
-
-目的：
-
-  * ビギナー・サポーターともに話しやすい状態にする
-
-やり方：
-
-  * ビギナー・サポーターそれぞれ同じテーブルの人たちに自分がどうしてこのワークショップに参加したかを話す
-    * 「声を出す」ことが大事。話題はなんでもよい。みんなが話せそうな話題だから「ワークショップの参加目的」にしているだけ。
-  * [Gitterのoss-gate/devel](https://gitter.im/oss-gate/devel)に登録する。
-    * 今回のワークショップだけでなく、今後のOSS開発でも相談できる場所。
-
-## 10:45 進め方の説明
-
-目的：
-
-  * ビギナーがどうやってOSS開発に着手すればよいかわかること
-
-今日の進め方を説明：
-
-  * 進め方の説明の途中でビギナーが開発対象とするOSSを決める
-    * 次のことを加味しながら決める。OSSの技術的な難易度はそれほど重視しなくてよい。
-      * ビギナーが使っているOSSにする
-      * ビギナーが困っているOSSにする（インストールがうまくいかないとか）
-
-  * 進め方の説明の途中で作業ログ保存用のOSSを決める
-    * [作業ログissueを作る](https://github.com/oss-gate/workshop/issues/new)。
-    * サポーターは担当するビギナーの作業ログへすぐにコメントを入れる
-      * 互いのアカウントが把握できるようになる
-      * ビギナーのログ更新をサポーターが通知で受け取れるようになる
-
-## 11:15 開発対象OSSを動かす
-
-目的：
-
-  * OSS開発に着手したときに最初にやるべき「動かすこと」を実際にやる
-
-目的達成のために達成したいこと：
-
-  * 困ったら相談するという習慣を身につけて欲しい
-    * 実際はリモートで相談することになるが、まずは隣同士、グループ内で相談できるようになる
-  * 動かすことに集中する
-    * 他のことに手を出したくなるかもしれないけど、まず動かすことが大事、ということを覚えてもらう
-  * ドキュメントに不備があるときに、文句を言う（Twitterでアピールするとか）よりも、次にドキュメントを読んだ人が困らないように直しておこう、と考える習慣を身につけてもらう
-    * 文句を言うことはスゴイことでもカッコイイことでもない！文句を言っている時間を使って直そう。
-
-やること：
-
-  * ドキュメント（READMEなど）に書いている通りにインストールしてみる
-    * ドキュメントにtypoや古い記述など不備があったら作業ログissueにメモしておく。理由は後でpull requestするから。
-    * インストール方法や使い方をググる前に公式ドキュメントを参照する習慣をつける。
-      * ググって見つかる非公式の情報がないと使えないOSSよりも公式ドキュメントを読めばわかるOSSにするべきで、そうなっていないなら私たちが開発に参加してよいものにするべき。
-  * インストールできたらドキュメントに書いている通りに動作を確認する
-
-## 12:15 ミニふりかえり
-
-目的：
-
-  * ふりかえりのリハーサル
-    * 作業ログが後で自分の役に立つことを実感してもらう
-  * 今後進むべき方向を確認して、午後を有意義に過ごすため
-
-目的のために達成したいこと：
-
-  * 「まず動かす」のときに作業ログをとる
-
-やること：
-
-  * サポーターの人数よりビギナーの人数が多い場合
-    * 1サポーターあたりn人のビギナーをフォローする
-    * 1人のビギナーがふりかえりをしている間、別のビギナーはなにか得られるものがないかという気持ちで見守る
-    * 1人終わったら別のビギナーと交代
-  * ビギナーは作業ログの内容を順にサポーターに説明する。
-  * サポーターは説明を聞いてビギナーにフィードバックをする。
-  * ふりかえりをしたサポーターはビギナーの作業ログにコメントを入れる
-    * 互いのアカウントが把握できるようになる
-    * ビギナーのログ更新をサポーターが通知で受け取れるようになる
-
-## 12:30 （昼食）
-
-近所にランチを食べに行きましょう。
-
-ビギナーは午前中に気になったことを進行役・サポーターに聞いてみてください。
-
-進行役・サポーターはビギナーに楽しんでいるか聞いてみてください。
-
-## 13:30 プロジェクトにフィードバックする
-
-目的：
-
-  * 「動かす」を実際にやってみて気づいたことをOSSプロジェクトにフィードバックすることを「体験」する
-
-目的達成のために達成したいこと：
-
-  * issueでもpull requestでもメールでのレポートでもなんでもよいのでフィードバックする
-
-やること：
-
-  * 「動かす」のなかで見つけたドキュメントの不備がどんなものか他の人に伝わるようにまとめる
-    * わかりにくかったところに対する改善案をまとめるのもよい。
-  * まずは自分の考えを整理する
-    * OSSの開発ではインターネット越しのやりとりが基本なので、文章で伝える必要がある。
-    * 少なくとも自分が理解できるような文章にまとめること。
-    * 自分の考えを文章にまとめるのは難しいと思うのでサポーターには考えの整理を手伝ってあげて欲しい。
-    * まとめたものは作業ログissueにコメント。
-  * 自分の考えがまとまったら開発者に伝わるようにまとめ直す
-    * 「読む人」が理解できることが大事
-    * このように報告してほしいとまとめているOSSもある。たとえば、GitHubを使っているOSSは`CONTRIBUTING.md`を使っていることがある。
-    * サポーターは読む人視点を伝えてあげて欲しい。
-    * これもまとめたものは作業ログissueにコメント。
-  * 実際に報告する
-    * これはupstream（開発元）のissueに報告。
-
-## 15:30 休憩
-
-10分休憩。
-
-## 15:40 ふりかえり
-
-目的：
-
-  * ビギナーのよい行動を伸ばすため
-  * ビギナーが困っていることを解決するため
-  * ビギナーが見過ごしている問題（= 解決するべき問題）を気づかせるため
-  * ビギナーが明日進むべき先を目指すため
-
-目的達成のために達成したいこと：
-
-  * ビギナーの作業ログを元にサポーターがビギナーをサポートする。
-
-やること：
-
-  * サポーターの人数よりビギナーの人数が多い場合
-    * 1サポーターあたりn人のビギナーをフォローする
-    * 1人のビギナーがふりかえりをしている間、別のビギナーはなにか得られるものがないかという気持ちで見守る
-    * 1人終わったら別のビギナーと交代
-  * ビギナーは作業ログの内容を順にサポーターに説明する。
-  * サポーターは説明を聞いてビギナーにフィードバックをする。
-  * ふりかえりをしたサポーターはビギナーの作業ログにコメントを入れてissueを閉じる
-    * 互いのアカウントが把握できるようになる
-
-## 15:55 まとめ
-
-目的：
-
-  * 今日やったことの意味を再確認する
-  * 今日やったことを明日以降に活かす
-
-目的達成のために達成したいこと：
-
-  * 参加者が以下を体験したことに気づく。
-    * 普段見逃しているだけでフィードバックポイントは今までもあった。
-    * フィードバックは実は難しくない。
-
-やること：
-
-  * 今日やったことを再確認
-  * 今日やったやりかたの思惑を説明
-  * 明日からのヒントを提示
-
-## 16:05 アンケート記入
-
-  * アンケートを記入する
-    * [アンケートの場所](https://github.com/oss-gate/workshop/tree/master/tutorial/retrospectives)
-  * このアンケートはこのあとの「ワークショップのふりかえり」ですぐに使う
-
-## 16:15 ワークショップのふりかえり
-
-  * アンケート結果をみながら今後もっとうまくやるにはどうすればよいかを検討する