rabbit-slide-kou-sezemi-2015-readable-code-code-change 2015.6.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.
@@ -0,0 +1,7 @@
1
+ ---
2
+ SHA1:
3
+ metadata.gz: 0cea370cfa06cae104916671ceaee46043f6dde6
4
+ data.tar.gz: e8c1593dfa234242fbdd2e8f042ea1294cf81284
5
+ SHA512:
6
+ metadata.gz: 07b40e612ef70db1e9d17fb1be70a25f9cf82b47cd983b888209276060784f1bba92c635da9c658de2900b2f26c43b1d2bd9bed90e1ab03b374729c57d283dc5
7
+ data.tar.gz: d49bd6c3dfedfce64ef2115c3f196d98762d87b669b6b2d92a35edf9c00e9079efee4f3aca7b20953aad51d1f7cde05482d4fb337b423e8b62895de56163a2bd
data/.rabbit ADDED
@@ -0,0 +1 @@
1
+ why-change.rab
@@ -0,0 +1,33 @@
1
+ = SEゼミ2015 - コードチェンジ
2
+
3
+ 2015年のSEゼミの「プログラミングが好きな学生のためのリーダブルコード勉
4
+ 強会」のコードチェンジのやり方の説明。
5
+
6
+ == ライセンス
7
+
8
+ CC BY-SA 4.0
9
+
10
+ 原著作者名は以下の通りです。
11
+
12
+ * 株式会社クリアコード
13
+
14
+ == 作者向け
15
+
16
+ === 表示
17
+
18
+ rake
19
+
20
+ === 公開
21
+
22
+ rake publish
23
+
24
+ == 閲覧者向け
25
+
26
+ === インストール
27
+
28
+ gem install rabbit-slide-kou-sezemi-2015-readable-code-icebreaker
29
+
30
+ === 表示
31
+
32
+ rabbit rabbit-slide-kou-sezemi-2015-readable-code-icebreaker.gem
33
+
@@ -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
@@ -0,0 +1,23 @@
1
+ ---
2
+ id: sezemi-2015-readable-code-code-change
3
+ base_name: next-step
4
+ tags:
5
+ - rabbit
6
+ - readable-code
7
+ - sezemi
8
+ presentation_date: 2015-06-06
9
+ version: 2015.6.6.0
10
+ licenses:
11
+ - CC BY-SA 4.0
12
+ slideshare_id: sezemi-2015-readable-code-code-change
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
@@ -0,0 +1,132 @@
1
+ = コードチェンジ
2
+
3
+ : author
4
+ 須藤功平
5
+ : institution
6
+ 株式会社クリアコード
7
+ : content-source
8
+ SEゼミ2015 - リーダブルコード勉強会
9
+ : date
10
+ 2015-06-06
11
+ : allotted-time
12
+ 5m
13
+ : theme
14
+ clear-code
15
+
16
+ = 目的の確認
17
+
18
+ (('tag:center'))(('tag:large'))
19
+ 参加者の\n
20
+ リーダブルコード力の\n
21
+ レベルアップ
22
+
23
+ ((' '))
24
+
25
+ = やろうとしていること
26
+
27
+ (1) コードを読んで
28
+ (2) リーダブルコードを((*見つける*))
29
+ (3) ↑を活かしてコードを書く
30
+
31
+ (('tag:center'))
32
+ (('tag:margin-top'))
33
+ ↑\n
34
+ OSSの開発では当たり前のこと
35
+
36
+ = 現状
37
+
38
+ (1) 全員共通の課題を用意←Done
39
+ (2) 課題を実装←Done
40
+ (3) 実装を交換←((*これから*))
41
+ (4) 交換した実装で開発継続
42
+
43
+ = どうして交換するのか
44
+
45
+ * コードを読まざるを得なくなる
46
+ * コードを読まずに開発継続できない
47
+ * 自分も実装した仕様
48
+ * 仕様は理解済み→読む敷居は低い
49
+ * 違う視点での実装を読むことになる
50
+ * 新しい発見があるはず
51
+
52
+ = やり方
53
+
54
+ * 交換相手を決める
55
+ * 交換相手のリポジトリーをfork
56
+ * ↑を使って開発継続
57
+
58
+ = 交換相手の決め方
59
+
60
+ * 基準
61
+ * だいたい同じ状況同士
62
+ * 例: 進み具合、環境
63
+ * メンターがヒアリング
64
+ * 積極的に協力して
65
+
66
+ = リポジトリーをfork
67
+
68
+ * やり方がわからない人は挙手
69
+
70
+ (('note:メンターへ:forkできているか確認してあげて'))
71
+
72
+ = 開発継続
73
+
74
+ * どこまで進んでいるかを確認
75
+ * READMEやlogを参考に\n
76
+ (('note:(どういう風に書いておけばよかったか考えてみて)'))
77
+ * ↑から開発を継続
78
+
79
+ = 忘れないで
80
+
81
+ * リーダブルコードを発見→メモ
82
+ * memo.mdに追記して随時push
83
+ * 後で共有する時に使う
84
+ * 書くこと
85
+ * 実際のコードまたはコードのURL
86
+ * リーダブルな理由
87
+ * 見つけたきっかけ
88
+
89
+ = ポイント
90
+
91
+ 悪いコードより\n
92
+ リーダブルな\n
93
+ コード
94
+
95
+ = 悪いコード
96
+
97
+ * 見つけやすい
98
+ * 異質
99
+ * リーダブルじゃない
100
+ * 過剰に指摘したくなる人がいる
101
+ * 指摘するならリーダブルなコードを書いてPull Request\n
102
+ (('note:コミットメッセージによくなる理由を書く'))\n
103
+ (('note:例: https://github.com/BLThunder1991/BLThunder1991-sezemi-2014-readable-code-2/pulls?q=is%3Aclosed'))
104
+
105
+ = リーダブルなコード
106
+
107
+ * 見つけにくい
108
+ * リーダブルだから
109
+ * すーっと理解できてひっかからない
110
+ * 今日のチャレンジ
111
+ * 意識して見つけよう!
112
+
113
+ = 発見方法のヒント
114
+
115
+ * リーダブルコード
116
+ * ((*読む人*))が\n
117
+ 読みやすいなら\n
118
+ リーダブル
119
+ * 読む人視点が重要
120
+ * 交換直後の今が読む人の視点!
121
+
122
+ = 忘れないで
123
+
124
+ * リーダブルコードを発見→メモ
125
+ * memo.mdに追記して随時push
126
+ * 後で共有する時に使う
127
+ * 書くこと(('note:(例はtask.mdに書いてある)'))
128
+ * コード・理由・見つけたきっかけ
129
+
130
+ (('note:メンターへ:メビューで使うのでメンターもメモろう'))
131
+
132
+ (('note:メンターへ:たまに「どんなメモ書いた?」と聞いて課題をこなすことではなくリーダブルコードを書くことに参加者の注意を向けてみよう'))
metadata ADDED
@@ -0,0 +1,80 @@
1
+ --- !ruby/object:Gem::Specification
2
+ name: rabbit-slide-kou-sezemi-2015-readable-code-code-change
3
+ version: !ruby/object:Gem::Version
4
+ version: 2015.6.6.0
5
+ platform: ruby
6
+ authors:
7
+ - Kouhei Sutou
8
+ autorequire:
9
+ bindir: bin
10
+ cert_chain: []
11
+ date: 2015-06-05 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: |-
42
+ 2015年のSEゼミの「プログラミングが好きな学生のためのリーダブルコード勉
43
+ 強会」のコードチェンジのやり方の説明。
44
+ email:
45
+ - kou@clear-code.com
46
+ executables: []
47
+ extensions: []
48
+ extra_rdoc_files: []
49
+ files:
50
+ - ".rabbit"
51
+ - README.rd
52
+ - Rakefile
53
+ - config.yaml
54
+ - pdf/sezemi-2015-readable-code-code-change-next-step.pdf
55
+ - why-change.rab
56
+ homepage: http://slide.rabbit-shocker.org/authors/kou/sezemi-2015-readable-code-code-change/
57
+ licenses:
58
+ - CC BY-SA 4.0
59
+ metadata: {}
60
+ post_install_message:
61
+ rdoc_options: []
62
+ require_paths:
63
+ - lib
64
+ required_ruby_version: !ruby/object:Gem::Requirement
65
+ requirements:
66
+ - - ">="
67
+ - !ruby/object:Gem::Version
68
+ version: '0'
69
+ required_rubygems_version: !ruby/object:Gem::Requirement
70
+ requirements:
71
+ - - ">="
72
+ - !ruby/object:Gem::Version
73
+ version: '0'
74
+ requirements: []
75
+ rubyforge_project:
76
+ rubygems_version: 2.2.2
77
+ signing_key:
78
+ specification_version: 4
79
+ summary: SEゼミ2015 - コードチェンジ
80
+ test_files: []