rabbit-slide-kou-readable-code-workshop-2015-03-06-conclusion 2015.3.6.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.
Files changed (8) hide show
  1. checksums.yaml +7 -0
  2. data/.rabbit +1 -0
  3. data/README.rd +32 -0
  4. data/Rakefile +17 -0
  5. data/config.yaml +23 -0
  6. data/next-step.rab +181 -0
  7. data/pdf/readable-code-workshop-2015-03-06-conclusion-next-step.pdf +0 -0
  8. metadata +78 -0
checksums.yaml ADDED
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: db1bf0a726e423ffd395f3fd1684e09be453620b
4
+ data.tar.gz: 77627e247a3c55bcd11ff5300965baa620c71391
5
+ SHA512:
6
+ metadata.gz: adc4bc37edc40c463839caa2df1a22c1231451679d8ebb5da391026cda405a75430535eac65d79b7c79a0e797ec98918e71648038895098f949d5a6300e00673
7
+ data.tar.gz: 519cad9b89b64c71cb26bf5402eb05db88dff5fa57d4d35a47dce988e33386baba2e374f4af0ae625b507e365221ab0b52c2331039b4a803382022db97713a1f
data/.rabbit ADDED
@@ -0,0 +1 @@
1
+ next-step.rab
data/README.rd ADDED
@@ -0,0 +1,32 @@
1
+ = 実践リーダブルコードのまとめ
2
+
3
+ 2015-03-06開催の実践リーダブルコードのまとめと次のステップの説明。
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-readable-code-workshop-2015-03-06-conclusion
28
+
29
+ === 表示
30
+
31
+ rabbit rabbit-slide-kou-readable-code-workshop-2015-03-06-conclusion.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
+ # spec.files += Dir.glob("doc/**/*.*")
9
+ # spec.files -= Dir.glob("private/**/*.*")
10
+ 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,23 @@
1
+ ---
2
+ id: readable-code-workshop-2015-03-06-conclusion
3
+ base_name: next-step
4
+ tags:
5
+ - rabbit
6
+ - readable-code
7
+ - sezemi
8
+ presentation_date: 2015-03-06
9
+ version: 2015.3.6.0
10
+ licenses:
11
+ - CC BY-SA 4.0
12
+ slideshare_id: readable-code-workshop-2015-03-06-conclusion
13
+ speaker_deck_id:
14
+ ustream_id:
15
+ vimeo_id:
16
+ youtube_id:
17
+ author:
18
+ markup_language: :rd
19
+ name: Kouhei Sutou
20
+ email: kou@clear-code.com
21
+ rubygems_user: kou
22
+ slideshare_user: kou
23
+ speaker_deck_user: kou
data/next-step.rab ADDED
@@ -0,0 +1,181 @@
1
+ = まとめと次のステップ
2
+
3
+ : author
4
+ 須藤功平
5
+ : institution
6
+ 株式会社クリアコード
7
+ : content-source
8
+ 実践リーダブルコード
9
+ : date
10
+ 2015-03-06
11
+ : allotted-time
12
+ 30m
13
+ : theme
14
+ clear-code
15
+
16
+ = 講座の目的
17
+
18
+ * 自分の開発チームに
19
+ * ((*リーダブルなコードが\n
20
+ 当たり前な文化の作り方*))を
21
+ * 持ち帰る
22
+
23
+ = 文化の作り方の流れ（1）
24
+
25
+ * リーダブルコードの必要性を\n
26
+ チームで共有
27
+ * 改良・修正が多いなら必要
28
+ * 継続的に改良・修正したいか
29
+ * チームとして改良・修正したいか
30
+
31
+ = 文化の作り方の流れ（2）
32
+
33
+ * チームでのリーダブルの基準を\n
34
+ 育てる
35
+ * 「読む人」が\n
36
+ 読みやすいなら\n
37
+ リーダブル
38
+ * 「読む人」が変われば基準が変わる
39
+ * →読む人が違うのでチーム毎に違う
40
+
41
+ = 文化の作り方の流れ（3）
42
+
43
+ * 基準の育て方
44
+ * 各メンバーがコードを読む
45
+ * リーダブルだと思ったコードを共有
46
+ * チームとしてリーダブルかを判断
47
+ * →チームの基準に加わる
48
+
49
+ = 基準の育て方（1）
50
+
51
+ * コードを読む文化を作る
52
+ * まず自分が読み始める
53
+ * リーダブルなコードを探す
54
+ * 見つけたリーダブルなコードを\n
55
+ 他のメンバーに伝える(('note:（後述）'))
56
+ * →コードが読まれるという自覚が\n
57
+ チームに浸透
58
+
59
+ (('tag:center'))
60
+ (('note:今日やったのはここまで'))
61
+
62
+ = 基準の育て方（2）
63
+
64
+ (('tag:center'))
65
+ (('note:次のステップ'))
66
+
67
+ * コミットを読む
68
+ * コード全体ではなく差分を読む
69
+ * 設計の仕方ではなく\n
70
+ 開発の仕方が見える
71
+ * リーダブルなコードを\n
72
+ 見つけるには適切
73
+
74
+ = 基準の育て方（3）
75
+
76
+ * コミットの読み方
77
+ * pull型よりpush型がよい\n
78
+ (('note:（Git用のオススメツールあり：git-utils）'))
79
+ * 読むコストが下がる
80
+ * 流し読む（負担が多いと続かない）
81
+ * 問題探し視点では読まない
82
+
83
+ = 基準の育て方（4）
84
+
85
+ * リーダブルコードの伝え方
86
+ * Wikiに書く（全チームで有効）
87
+ * コードで伝える（上級チーム向け）
88
+
89
+ = 基準の育て方（5）
90
+
91
+ * Wikiに書いて伝える
92
+ * Wikiもdiffを通知できるようにする\n
93
+ (('note:（RedmineとGitHub用はツールあり）'))
94
+ * 後で参照できるため
95
+ * 更新もできるため\n
96
+ (('note:（リーダブルコードの基準は変わることもある！）'))
97
+
98
+ = 基準の育て方（6）
99
+
100
+ * コードで伝える
101
+ * 上級チーム向け\n
102
+ (('note:（チームにコードを読む文化が根付いた後）'))
103
+ * リーダブルコードを真似てコミット
104
+ * →他の人：「またこの書き方だ」
105
+ * →真似する人増加→チームが合意
106
+ * →チームが合意→Wikiにまとめる
107
+
108
+ = おまけ：副次効果
109
+
110
+ * コードを読む文化
111
+ * 新しい人の受け入れにも有用
112
+ * 自分たちが大事にしていることを\n
113
+ 開発を通じて徐々に伝えていける
114
+
115
+ = 来週からやること
116
+
117
+ * リーダブルコードの必要性を\n
118
+ チームで確認
119
+ * →この講座をチームでもやる
120
+ * 資料はすべて再利用可能
121
+ * →自分がコードを読み始める
122
+ * 自分が変更するコードの周辺から\n
123
+ リーダブルコードを探す
124
+
125
+ = サポート（1）
126
+
127
+ * 今日の資料はすべて再利用可能
128
+ * チーム内で同じ講座をできる
129
+ * 無料のフォローアップ面談
130
+ * チームで実践→悩み\n
131
+ ↑の相談に乗る
132
+ * 受講後3ヶ月以内、1回限り
133
+
134
+ = サポート（2）
135
+
136
+ * コミット読みの支援
137
+ * OSSとしてツールを公開
138
+ * コミット毎にメールで通知(('note:（diff入り）'))
139
+ * Git、Subversionで使える
140
+ * GitHub、GitLab連携もできる
141
+
142
+ = おしらせ（1）
143
+
144
+ * WEB+DB PRESS Vol.86に寄稿
145
+ * よいコード・よいコミットについて
146
+ * 2015-4-24発売予定
147
+ * http://www.amazon.co.jp/dp/4774172480
148
+
149
+ = おしらせ（2）
150
+
151
+ (('tag:center'))
152
+ コードリーダー育成支援\n
153
+ (('note:http://www.clear-code.com/services/code-reader/'))
154
+
155
+ (('tag:center'))
156
+ リーダブルなコードが\n
157
+ 当たり前な文化づくりを支援
158
+
159
+ = トラブルシューティング
160
+
161
+ (('tag:center'))
162
+ 1人で始めたまま\n
163
+ なかなかチームに広げられない
164
+
165
+ * 実績を元に\n
166
+ リーダーや○○長に協力依頼
167
+ * 実績例：リーダブル基準集
168
+ * 前述の支援サービスを使う
169
+ * →組織として本気で取り組むぞ！\n
170
+ というメッセージになる
171
+
172
+ = クリアコード
173
+
174
+ * クリアなコードが大切
175
+ * クリア == clear == 意図が明確
176
+ * クリアなコードはリーダブルコード
177
+
178
+ (('tag:center'))
179
+ みなさんのチームが\n
180
+ リーダブルコードが当たり前な\n
181
+ チームになることを応援します！
metadata ADDED
@@ -0,0 +1,78 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: rabbit-slide-kou-readable-code-workshop-2015-03-06-conclusion
3
+ version: !ruby/object:Gem::Version
4
+ version: 2015.3.6.0
5
+ platform: ruby
6
+ authors:
7
+ - Kouhei Sutou
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2015-03-06 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: 2015-03-06開催の実践リーダブルコードのまとめと次のステップの説明。
42
+ email:
43
+ - kou@clear-code.com
44
+ executables: []
45
+ extensions: []
46
+ extra_rdoc_files: []
47
+ files:
48
+ - ".rabbit"
49
+ - README.rd
50
+ - Rakefile
51
+ - config.yaml
52
+ - next-step.rab
53
+ - pdf/readable-code-workshop-2015-03-06-conclusion-next-step.pdf
54
+ homepage: http://slide.rabbit-shocker.org/authors/kou/readable-code-workshop-2015-03-06-conclusion/
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.2.2
75
+ signing_key:
76
+ specification_version: 4
77
+ summary: "実践リーダブルコードのまとめ"
78
+ test_files: []