rabbit-slide-oss-gate-workshop-tutorial-online 2021.10.30.0

data/scenario.rab

@@ -0,0 +1,639 @@
+= OSS Gate\nワークショップ\nオンライン版
+
+: theme
+   .
+
+= 雑談タイム
+
+  * せっかくなので
+    色々質問してみよう
+
+= アイスブレイク
+
+  * 目的
+    * 他の人と話しやすくなること\n
+      (('note:せっかくだから相談しよう！'))
+  * やること
+    * 参加目的をみんなに説明\n
+      ※内容より((*声を出すことが大事！*))
+    * まずはサポーターから発声\n
+      (('note:順番はスムーズな進行のために指定しているだけ。'))
+
+= チャット：Discord
+
+  * ボイスチャンネル
+    * #一般：全体向けアナウンス
+    * #グループN：各グループの作業用
+  * テキストチャンネル
+    * #YYYY-MM-DD：今日の連絡用
+    * #グループN：各グループの連絡用
+
+= チャット：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手段
+    * ((*未*))経験者が経験者になると増える
+
+= ((*OSS開発者*))や((*OSSコントリビューター*))ってどんなイメージ？
+
+  * 予想：
+    * (('wait'))技術力が高い人\n
+      すごい人\n
+      意識が高い人\n
+      別世界の人
+
+= 実際は
+
+  * OSSプロジェクトに\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:ビギナーと一緒に悩んであげよう！'))
+
+= 対象OSS決めのヒント
+
+  * 使っているOSSから選ぶ\n
+    (('note:ブラウザの拡張機能・便利なコマンドラインツール等'))\n
+    (('note:無意識で使っている物の中にもOSSはある'))
+    * 難易度は気にしなくてよい！\n
+      (('note:サポーターがサポートするから！'))
+    * 小規模なプロジェクトや\n
+      新しめのプロジェクトは狙い目\n
+      (('note:フィードバックできる部分が多い'))
+
+= 対象OSS決めデモ
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * 最近使っているOSSは？
+    * ライセンス確認→OK！
+  * その中で一番ときめくのは？
+  * ではそれにしましょう！
+
+= 動かすときのポイント
+
+  * 作業メモを書く
+    * 🔜メモを書く場所はこのあと作る
+  * なにかする毎に書く
+    * 例：ドキュメントを読み始めた
+    * 例：次のドキュメントを読み始めた
+
+= 作業メモを書く場所を作る
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  (1) GitHub: oss-gate/workshop
+  (2) ↑にissueを作る
+  (3) 周囲のビギナーの人たちが\n
+      作ったissueにコメント
+
+= 作業メモの例
+
+  ドキュメント通りインストールしたけど
+  失敗した。
+
+= よりよい作業メモの例
+
+  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) 公式サイトを開く
+  (2) 作業メモを書く
+  (3) 概要を読む
+  (4) 作業メモを書く
+  (5) ...
+
+= ふりかえり1
+
+(('tag:center'))
+(('tag:x-large'))
+…●時▲分！
+
+  * これまでの活動を見直す機会
+
+  * 目的：
+    * 他の人の視点での考え方を知る
+    * 作業ログが役に立つことを実感
+
+= ふりかえり1：デモ
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * ビギナー：
+    * 作業メモを読む
+  * サポーター：
+    * 気になることをビギナーに質問
+    * フィードバックポイントを確認
+    * 完了→issueにコメント
+
+= ふりかえり1：進め方
+
+  * サポーターを他の人に交代
+  * 対象ビギナーの作業ログを\n
+    ディスプレイに映す
+  * ビギナーが作業メモを読む
+  * 時間が余ったら：
+    * 他のビギナーにも説明
+
+= 休憩/雑談タイム
+
+(('tag:center'))
+(('tag:x-large'))
+●時▲分まで！
+
+  * せっかくなので
+    色々質問してみよう
+
+= 現状確認
+
+  (1) (('del:ユーザーとして動かす'))
+  (2) (('del:ふりかえり1'))
+  (3) (('del:フィードバックポイントを'))\n
+      (('del:発見！'))
+  (4) (('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:x-large'))
+●時▲分まで！
+
+(('note:前半と同じサポーターに見てもらう'))
+
+  (1) 整理する
+  (2) 開発者にとってわかりやすくなるように編集する
+  (3) 適切な場所に報告する
+  (4) ...
+
+= ふりかえり2：デモ
+
+(('tag:center'))
+(('tag:x-large'))
+デモ
+
+  * ビギナー：
+    * 作業メモを読む
+  * サポーター：
+    * ((*よかったことをよい！と言う*))
+    * 気になることをビギナーに質問
+    * 完了→issueにコメント
+
+= ふりかえり2：進め方
+
+  * サポーターを他の人に交代
+  * 対象ビギナーの作業ログを\n
+    ディスプレイに映す
+  * ビギナーが作業メモを読む
+  * 時間が余ったら：
+    * 他のビギナーにも説明
+
+= まとめ
+
+  * 今日やったことを再確認
+  * 明日からのことを確認
+
+= 目的の確認
+
+(('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-***
+      * 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,2 @@
+@font_family = find_font_family("モトヤLマルベリ3等幅") || @font_family
+include_theme("clear-blue")