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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
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: []