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 +7 -0
- data/.rabbit +1 -0
- data/README.rd +32 -0
- data/Rakefile +17 -0
- data/config.yaml +22 -0
- data/how-to-report.rab +125 -0
- data/pdf/workshop-tutorial-feedback-how-to-report.pdf +0 -0
- metadata +78 -0
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
|
+
= デモ
|
Binary file
|
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: []
|