rabbit-slide-kou-sezemi-2015-oss-hack-4-beginners-feedback 2015.6.27.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: bac1d667d858622cbb20eae8a3ec8f2f4fdbb8aa
+  data.tar.gz: d952c9259d6d8f66b1dc168dd309a55a9267f54a
+SHA512:
+  metadata.gz: 9bde9b385c573373232a3356664701a7e2c387bb607509febd303e81834f8937b64398503c331c535859527153f4a002217cee924376fc6f19d1ec75374eb749
+  data.tar.gz: ef3dad2254fb588acf00976450db689581c8ad34eb59903377819d8894729f51cca5071fabd37328c674dc7c9b961690b565d5a4d4a770d4d9c1e449897ee1e2

data/.rabbit

@@ -0,0 +1 @@
+how-to-report.rab

data/README.rd

@@ -0,0 +1,33 @@
+= SEゼミ2015 - OSS Hack 4 Beginners - フィードバック
+
+2015年のSEゼミの「プログラミングが好きな学生のための勉強会 - OSS Hack
+4 Beginners」でのフィードバックの送り方の説明。
+
+== ライセンス
+
+CC BY-SA 4.0
+
+原著作者名は以下の通りです。
+
+  * 株式会社クリアコード
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-sezemi-2015-oss-hack-4-beginners-feedback
+
+=== 表示
+
+  rabbit rabbit-slide-kou-sezemi-2015-oss-hack-4-beginners-feedback.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # task.spec.files += Dir.glob("doc/**/*.*")
+  # task.spec.files -= Dir.glob("private/**/*.*")
+  task.spec.add_runtime_dependency("rabbit-theme-clear-code")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,23 @@
+---
+id: sezemi-2015-oss-hack-4-beginners-feedback
+base_name: how-to-report
+tags:
+- rabbit
+- sezemi
+- oss
+presentation_date: 2015-06-27
+version: 2015.6.27.0
+licenses:
+- CC BY-SA 4.0
+slideshare_id: sezemi-2015-oss-hack-4-beginners-feedback
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+author:
+  markup_language: :rd
+  name: Kouhei Sutou
+  email: kou@clear-code.com
+  rubygems_user: kou
+  slideshare_user: kou
+  speaker_deck_user: kou

data/how-to-report.rab

@@ -0,0 +1,138 @@
+= フィードバック
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   SEゼミ2015 - OSS Hack 4 Beginners
+: date
+   2015-06-27
+: allotted-time
+   15m
+: theme
+   clear-code
+
+= 目的の確認
+
+参加者の\n
+OSS開発参加への\n
+不安を払拭
+
+= 現状確認
+
+  * 動かした？
+    * インストールはできた？
+    * ドキュメント通り実行できた？
+  * 開発用にインストールした？
+  * テストを実行した？
+  * 楽しんだ？
+
+= フィードバック
+
+  * メモが溜まっているはず
+    * 不備があることを書いたやつ
+    * うまくいかないことを書いたやつ
+  * upstream（開発元）に報告
+
+= 報告方法
+
+  (1) 整理する
+      * 自分の考えが文章になればOK
+  (2) (('wait'))((*開発者にとって*))\n
+      リーダブルになるように編集
+  (3) (('wait'))適切な場所に報告
+      * GitHubのissueとか
+
+= 1. 整理する
+
+  * 自分で自分の気持ちを理解
+    * 自分が読んで理解できる文章に\n
+      まとめられれば理解できている
+    * 自分が理解できていないことは\n
+      開発者にも伝えられない！
+    * まとめて自分のissueにコメント
+
+(('note:メンターへ：メモ（断片）の文書化を手伝って'))\n
+(('note:例：考えを整理できるような質問をする'))
+
+= 2. 編集する
+
+  * ((*開発者にとって*))\n
+    リーダブルになるように編集
+    * 「読む人」が理解できることが大事\n
+      なのは報告もコードも同じ
+    * まとめて自分のissueにコメント
+
+(('note:メンターへ：リーダブル化を手伝って'))\n
+(('note:例：自分が開発者ならこう読めると開発者視点を伝える'))\n
+(('note:メンターへ：他の開発者のことを考える人と一緒に働きたい？'))
+
+= ヒント：OSS開発の前提
+
+  * 時間的・空間的に離れている
+    * 朝型・夜型・平日・休日・海外…
+    * 区外・都外・県外・海外…
+    * →直接会わない
+  * でも、情報共有は必要！
+    * →インターネット越しに相談
+
+= OSS開発での相談
+
+  * 前提
+    * インターネット越し
+  * ポイント
+    * ((*相手が*))わかるように書く
+    * 例：省略しない（具体的に書く）
+
+= 省略例
+
+  # blockquote
+
+  インストールしました。
+
+  動きませんでした。
+
+  どうしたらいいでしょうか？
+
+= 省略しない例
+
+  # blockquote
+
+  次のコマンドでインストールしました。
+
+    % sudo apt-get install ...
+    （...実行結果...）
+
+  ↑のように失敗しました。
+
+  環境：Ubuntu 15.04 amd64
+
+= なぜ省略しないか
+
+  * 相手は私を知らない(('note:（共通知識が少ない）'))
+    * →省略すると((*想像*))しないといけない
+    * だいたい((*想像は外れる*))
+    * →認識違いでおかしなことに…
+  * 相手が理解に必要な時間を減少
+    * リーダブルコードと同じ目標！
+
+= 省略しないとは
+
+  * 詳細を書く
+    * 実行したコマンド・実行結果
+  * やったことを書く
+  * ((*やっていないこと*))を書く
+  * 期待した結果を書く
+
+(('note:メンターへ：速くできた人には別のissueでも練習してもらって'))\n
+(('note:メンターへ：全員が少なくとも1つまとめたら報告にいく'))
+
+= 3. 報告する
+
+  * 適切な場所に報告
+    * 今回はGitHubのissue
+    * OSSによって報告場所は違う
+  * メンターへ
+    * issue登録に二の足を踏んでいる人の背中を押してあげて\n
+      (('note:例：自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える'))

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-sezemi-2015-oss-hack-4-beginners-feedback
+version: !ruby/object:Gem::Version
+  version: 2015.6.27.0
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-23 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !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: |-
+  2015年のSEゼミの「プログラミングが好きな学生のための勉強会 - OSS Hack
+  4 Beginners」でのフィードバックの送り方の説明。
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- how-to-report.rab
+- pdf/sezemi-2015-oss-hack-4-beginners-feedback-how-to-report.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/sezemi-2015-oss-hack-4-beginners-feedback/
+licenses:
+- CC BY-SA 4.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: SEゼミ2015 - OSS Hack 4 Beginners - フィードバック
+test_files: []