rabbit-slide-oss-gate-workshop-tutorial-feedback 2016.11.26.0

Sign up to get free protection for your applications and to get access to all the features.
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: aef2e8b714891e3ac9e0f33ec87087aef17abeaf
4
+ data.tar.gz: 290381372762d1dcb572a04227afcf82dcefa666
5
+ SHA512:
6
+ metadata.gz: 807edbd70a3c30874b9b98a86db020b87011bb9023e418754ef097606d3de64833968b5b8da15b5629b9d8a767c1d548c8fa9819340785aa5cb739a6900d7855
7
+ data.tar.gz: 2e19402f200e87fb6cca0e340b651921c863dde973970f3c91c38b87428a1dec07567c43d6eb7b0a69f0ade35d9fba1aae966910708e9503e4f0057a9203b136
data/.rabbit ADDED
@@ -0,0 +1 @@
1
+ how-to-report.rab
data/README.rd ADDED
@@ -0,0 +1,32 @@
1
+ = OSS Gateワークショップ(チュートリアル) - フィードバック
2
+
3
+ OSS Gateワークショップ(チュートリアル)でのフィードバックの送り方の説明。
4
+
5
+ == ライセンス
6
+
7
+ CC BY-SA 4.0
8
+
9
+ 原著作者名は以下の通りです。
10
+
11
+ * 株式会社クリアコード
12
+
13
+ == 作者向け
14
+
15
+ === 表示
16
+
17
+ rake
18
+
19
+ === 公開
20
+
21
+ rake publish
22
+
23
+ == 閲覧者向け
24
+
25
+ === インストール
26
+
27
+ gem install rabbit-slide-kou-oss-gate-workshop-tutorial-feedback
28
+
29
+ === 表示
30
+
31
+ rabbit rabbit-slide-kou-oss-gate-workshop-tutorial-feedback.gem
32
+
data/Rakefile ADDED
@@ -0,0 +1,17 @@
1
+ require "rabbit/task/slide"
2
+
3
+ # Edit ./config.yaml to customize meta data
4
+
5
+ spec = nil
6
+ Rabbit::Task::Slide.new do |task|
7
+ spec = task.spec
8
+ # task.spec.files += Dir.glob("doc/**/*.*")
9
+ # task.spec.files -= Dir.glob("private/**/*.*")
10
+ task.spec.add_runtime_dependency("rabbit-theme-clear-code")
11
+ end
12
+
13
+ desc "Tag #{spec.version}"
14
+ task :tag do
15
+ sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
16
+ sh("git", "push", "--tags")
17
+ end
data/config.yaml ADDED
@@ -0,0 +1,22 @@
1
+ ---
2
+ id: workshop-tutorial-feedback
3
+ base_name: how-to-report
4
+ tags:
5
+ - rabbit
6
+ - oss_gate
7
+ presentation_date: 2016-11-26
8
+ version: 2016.11.26.0
9
+ licenses:
10
+ - CC BY-SA 4.0
11
+ slideshare_id:
12
+ speaker_deck_id:
13
+ ustream_id:
14
+ vimeo_id:
15
+ youtube_id:
16
+ author:
17
+ markup_language: :rd
18
+ name: OSS Gate
19
+ email: kou+oss-gate@cozmixng.org
20
+ rubygems_user: oss-gate
21
+ slideshare_user:
22
+ speaker_deck_user:
data/how-to-report.rab ADDED
@@ -0,0 +1,125 @@
1
+ = フィードバック
2
+
3
+ : author
4
+ OSS Gate
5
+ : content-source
6
+ OSS Gateワークショップ
7
+ : date
8
+ 2016-09-24
9
+ : allotted-time
10
+ 15m
11
+ : theme
12
+ clear-blue
13
+
14
+ = 目的の確認
15
+
16
+ (('tag:center'))
17
+ (('tag:x-large'))
18
+ OSS開発((*未*))経験者\n
19
+ ↓\n
20
+ OSS開発 経験者
21
+
22
+ = 現状確認
23
+
24
+ * インストールはできた?
25
+ * ドキュメント通り実行できた?
26
+ * (('wait'))((*楽しんだ?*))
27
+
28
+ = フィードバック
29
+
30
+ * メモが溜まっているはず
31
+ * 不備があることを書いたやつ
32
+ * うまくいかないことを書いたやつ
33
+ * upstream(開発元)に報告
34
+
35
+ = 報告方法
36
+
37
+ (1) 整理する
38
+ * 自分の考えが文章になればOK
39
+ (2) (('wait'))((*開発者にとって*))\n
40
+ わかりやすくなるように編集
41
+ (3) (('wait'))適切な場所に報告
42
+ * GitHubのissueとか
43
+
44
+ = 1. 整理する
45
+
46
+ * 自分で自分の気持ちを理解
47
+ * 自分が読んで理解できる文章に\n
48
+ まとめられれば理解できている
49
+ * 自分が理解できていないことは\n
50
+ 開発者にも伝えられない!
51
+ * まとめて自分のissueにコメント
52
+ * メンターに確認依頼
53
+
54
+ (('note:メンターへ:メモ(断片)の文書化を手伝って'))\n
55
+ (('note:例:考えを整理できるような質問をする'))
56
+
57
+ = 2. 編集する
58
+
59
+ * ((*開発者にとって*))\n
60
+ わかりやすくなるように編集
61
+ * 報告方針をまとめているOSSもある\n
62
+ (('note:例:GitHubにあるCONTRIBUTING.md'))
63
+ * まとめて自分のissueにコメント
64
+ * メンターに確認依頼
65
+
66
+ (('note:メンターへ:リーダブル化を手伝って'))\n
67
+ (('note:例:自分が開発者ならこう読めると開発者視点を伝える'))\n
68
+
69
+ = OSS開発での相談
70
+
71
+ * 前提
72
+ * インターネット越し
73
+ * ポイント
74
+ * ((*相手が*))わかるように書く
75
+ * 例:省略しない(具体的に書く)
76
+
77
+ = 省略例
78
+
79
+ # blockquote
80
+
81
+ インストールしました。
82
+
83
+ 動きませんでした。
84
+
85
+ どうしたらいいでしょうか?
86
+
87
+ = 省略しない例
88
+
89
+ # blockquote
90
+
91
+ 次のコマンドでインストールしました。
92
+
93
+ % sudo apt-get install ...
94
+ (...実行結果...)
95
+
96
+ ↑のように失敗しました。
97
+
98
+ 環境:Ubuntu 15.04 amd64
99
+
100
+ = なぜ省略しないか
101
+
102
+ * 相手は私を知らない(('note:(共通知識:少)'))
103
+ * →省略すると((*想像*))しないといけない
104
+ * だいたい((*想像は外れる*))
105
+ * →認識違いでおかしなことに…
106
+ * 相手が理解に必要な時間が減少
107
+ * やりとりがスムーズになる
108
+
109
+ = 省略しないとは
110
+
111
+ * 詳細を書く
112
+ * 実行したコマンド・実行結果
113
+ * やったことを書く
114
+ * ((*やっていないこと*))を書く
115
+ * 期待した結果を書く
116
+
117
+ = 3. 報告する
118
+
119
+ * 適切な場所に報告
120
+ * OSSによって報告場所は違う
121
+ * メンターへ
122
+ * 報告に二の足を踏んでいる人の背中を押してあげて\n
123
+ (('note:例:自分が開発者ならこの報告をもらったらうれしい、と開発者視点を伝える'))
124
+
125
+ = デモ
metadata ADDED
@@ -0,0 +1,78 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: rabbit-slide-oss-gate-workshop-tutorial-feedback
3
+ version: !ruby/object:Gem::Version
4
+ version: 2016.11.26.0
5
+ platform: ruby
6
+ authors:
7
+ - OSS Gate
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2016-11-12 00:00:00.000000000 Z
12
+ dependencies:
13
+ - !ruby/object:Gem::Dependency
14
+ name: rabbit
15
+ requirement: !ruby/object:Gem::Requirement
16
+ requirements:
17
+ - - ">="
18
+ - !ruby/object:Gem::Version
19
+ version: 2.0.2
20
+ type: :runtime
21
+ prerelease: false
22
+ version_requirements: !ruby/object:Gem::Requirement
23
+ requirements:
24
+ - - ">="
25
+ - !ruby/object:Gem::Version
26
+ version: 2.0.2
27
+ - !ruby/object:Gem::Dependency
28
+ name: rabbit-theme-clear-code
29
+ requirement: !ruby/object:Gem::Requirement
30
+ requirements:
31
+ - - ">="
32
+ - !ruby/object:Gem::Version
33
+ version: '0'
34
+ type: :runtime
35
+ prerelease: false
36
+ version_requirements: !ruby/object:Gem::Requirement
37
+ requirements:
38
+ - - ">="
39
+ - !ruby/object:Gem::Version
40
+ version: '0'
41
+ description: OSS Gateワークショップ(チュートリアル)でのフィードバックの送り方の説明。
42
+ email:
43
+ - kou+oss-gate@cozmixng.org
44
+ executables: []
45
+ extensions: []
46
+ extra_rdoc_files: []
47
+ files:
48
+ - ".rabbit"
49
+ - README.rd
50
+ - Rakefile
51
+ - config.yaml
52
+ - how-to-report.rab
53
+ - pdf/workshop-tutorial-feedback-how-to-report.pdf
54
+ homepage: http://slide.rabbit-shocker.org/authors/oss-gate/workshop-tutorial-feedback/
55
+ licenses:
56
+ - CC BY-SA 4.0
57
+ metadata: {}
58
+ post_install_message:
59
+ rdoc_options: []
60
+ require_paths:
61
+ - lib
62
+ required_ruby_version: !ruby/object:Gem::Requirement
63
+ requirements:
64
+ - - ">="
65
+ - !ruby/object:Gem::Version
66
+ version: '0'
67
+ required_rubygems_version: !ruby/object:Gem::Requirement
68
+ requirements:
69
+ - - ">="
70
+ - !ruby/object:Gem::Version
71
+ version: '0'
72
+ requirements: []
73
+ rubyforge_project:
74
+ rubygems_version: 2.5.1
75
+ signing_key:
76
+ specification_version: 4
77
+ summary: OSS Gateワークショップ(チュートリアル) - フィードバック
78
+ test_files: []