rabbit-slide-kou-sprk2012 2012.09.16

data/.rabbit

@@ -0,0 +1 @@
+how-to-make-clear-code.rab

data/COPYING

@@ -0,0 +1,7 @@
+readable-code.jpeg:
+  * License: CC BY-SA 3.0
+  * Author: オライリー・ジャパン
+
+Others:
+  * License: CC BY-SA 3.0
+  * Author: Kouhei Sutou

data/README.rd

@@ -0,0 +1,30 @@
+= クリアなコードの作り方 - How to make clear code
+
+私はコードを書くことが好きです。もっと言うとクリアなコードを書くことが
+好きです。クリアなコードを書くことはとても楽しいので、みんながクリアな
+コードを書けるようになればいいなぁと思っています。そこで、私がどうやっ
+てクリアなコードを書いているかを紹介します。
+I like coding. I say more. I like coding clear code. I hope that we
+can code clear code because coding clear code is very fun. I'll talk
+about how I code clear code.
+
+== For author
+
+=== Show
+
+  rake
+
+=== Publish
+
+  rake publish
+
+== For viewers
+
+=== Install
+
+  gem install rabbit-slide-kou-sprk2012
+
+=== Show
+
+  rabbit rabbit-slide-kou-sprk2012.gem
+

data/Rakefile

@@ -0,0 +1,22 @@
+# Copyright (C) 2012  Kouhei Sutou <kou@cozmixng.org>
+#
+# License: CC BY-SA 3.0
+#
+# This program is free software: you can redistribute it and/or modify
+# it under the terms of the GNU General Public License as published by
+# the Free Software Foundation, either version 3 of the License, or
+# (at your option) any later version.
+#
+# This program is distributed in the hope that it will be useful,
+# but WITHOUT ANY WARRANTY; without even the implied warranty of
+# MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+# GNU General Public License for more details.
+#
+# You should have received a copy of the GNU General Public License
+# along with this program.  If not, see <http://www.gnu.org/licenses/>.
+
+require "rabbit/task/slide"
+
+Rabbit::Task::Slide.new do |task|
+  task.spec.add_runtime_dependency("rabbit-theme-clear-code")
+end

data/config.yaml

@@ -0,0 +1,20 @@
+---
+id: sprk2012
+base_name: how-to-make-clear-code
+tags:
+- rabbit
+- sprk2012
+- clear code
+presentation_date: 2012/09/16
+version: 2012.09.16
+licenses:
+- CC BY-SA 3.0
+slideshare_id: how-to-make-clear-code
+speaker_deck_id: how-to-make-clear-code
+author:
+  markup_language: rd
+  name: Kouhei Sutou
+  email: kou@clear-code.com
+  rubygems_user: kou
+  slideshare_user: kou
+  speaker_deck_user: kou

data/how-to-make-clear-code.rab

@@ -0,0 +1,368 @@
+= クリアなコードの\n作り方
+
+: subtitle
+   How to make clear code
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   札幌Ruby会議2012
+: date
+   2012/09/16
+: allotted-time
+   25m
+: theme
+   clear-code
+
+= クリアなコードの作り方\n(('note:(How to make clear code)'))
+
+(('wait'))
+We Code.\n
+Period.\n
+(('note:（以上）'))
+
+= クリアなコード？\n(('note:(Clear code?)'))
+
+(('wait'))
+自然なコード\n
+(('note:(Natural code)'))
+
+== メモ
+=== クリアなコード\n(('note:(Clear code)'))
+
+  # blockquote
+  クリアなコードっていうのは、読んだら「おぉー！」ってなるもんじゃなく
+  て、しばらく読んでて「あれ？ずいぶんするっと読めるなぁ」って思ったと
+  きに「あぁ、これはクリアなコードだなぁ」と気付くもんなんじゃないかなぁ。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/199838535073808385'))
+
+= クリアなコード\n(('note:(Clear code)'))
+
+  # blockquote
+  かっこよくもなければ\n
+  膝を打つものでもない、\n
+  自然なコード。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/199838535073808385'))
+
+= クリアなコードと私\n(('note:(Clear code and I)'))
+
+とても\n大事にしていること\n
+(('note:(It's very important to me)'))
+
+= どうして？\n(('note:(Why should we code clear code?)'))
+
+たのしく開発を続けたいから\n
+(('note:(Because I want to keep developing in a joyful way)'))
+
+= 私\n(('note:(Me)'))
+
+プログラミングが好き\n
+(('note:(I love programming)'))
+
+= 開発\n(('note:(Development)'))
+
+たのしい\n
+(('note:(Joyful)'))
+
+= たのしくない開発\n(('note:(Joyless development)'))
+
+汚いコード\n
+(('note:(Dirty code...)'))
+
+= もっとたのしくない開発\n(('note:(More joyless development)'))
+
+汚れていく\nコード\n
+(('note:(Code gets dirty...)'))
+
+= 汚れていくコード\n(('note:(Code gets dirty...)'))
+
+  * 直しても直しても\n
+    他の人が汚していく\n
+    (('note:(I clean codes but others make codes dirty...)'))
+  * 掃除しているそばから\n
+    ゴミを捨てられているよう\n
+    (('note:(Like ... I can't translate it... :<)'))
+
+= 続けられない！\n(('note:I can't keep developing!'))
+
+= どうしてクリアなコード？\n(('note:(Why should we code clear code?)'))
+
+みんなで\n
+たのしく開発を続けたいから\n
+(('note:(Because I want to keep developing in a joyful way)'))
+
+= どうしてこのトークを？\n(('note:(Why do I this talk?)'))
+
+みんなも\nクリアなコード\n書いて！\nたのしいから！\n
+(('note:(Please code clear code! It's joyful!)'))
+
+= We Code.
+
+= ((*C*))ode ((*C*))lear ((*C*))ode
+
+= クリアなコードの作り方\n(('note:(How to make clear code)'))
+
+  * みんなでクリアなコードにする\n
+    (('note:(We make clear code)'))
+    * 他の人のことを考えて書く\n
+      (('note:(Write codes for others)'))
+    * 他の人のコードを読む\n
+      (('note:(Read codes by others)'))
+
+== メモ
+=== どういうこと？\n(('note:(What does it mean?)'))
+
+文化にしよう！
+
+== メモ
+
+  # blockquote
+  人と一緒にコードを書いて、\n
+  人のコードを見て\n
+  プログラマーは\n
+  良くなっていくんだ
+
+(('tag:center'))
+(('note:札幌Ruby会議02に行ってみて初心に帰った'))\n
+(('note:http://adzuki34.blogspot.jp/2009/12/ruby02.html'))
+
+= 解説参照
+
+  # image
+  # src = readable-code.jpeg
+  # relative_height = 90
+  # reflect_ratio = 0.15
+
+= リーダブルコードの解説\n(('note:(The comment of readable code)'))
+
+  (1) 実際にやる\n
+      (('note:(Do it)'))
+  (2) 当たり前にする\n
+      (('note:(Make coding readable code natural)'))
+  (3) コードで伝える\n
+      (('note:(Communicate by readable code)'))
+
+(('tag:center'))
+(('note:CC BY-NC-SA 3.0で公開されている'))\n
+(('note:You can translate it into English!!!'))\n
+(('note:http://www.clear-code.com/blog/2012/6/11.html'))
+
+= リーダブルコードの解説
+
+  (1) 実際にやる(('note:(Do it)'))
+      * 書く(('note:(Write)'))
+  (2) 当たり前にする(('note:(Make natural)'))
+      * 書く・読む(('note:(Write and Read)'))
+  (3) コードで伝える(('note:(Communicate by code)'))
+      * 書く・読む・書く(('note:(Write, Read and Write)'))
+
+= リーダブルコードの解説
+
+  (1) 実際にやる(('note:(Do it)'))
+      * ((*書く*))(('note:(Write)'))
+  (2) 当たり前にする(('note:(Make natural)'))
+      * 書く・読む(('note:(Write and Read)'))
+  (3) コードで伝える(('note:(Communicate by code)'))
+      * 書く・読む・書く(('note:(Write, Read and Write)'))
+
+== メモ
+=== 自分が動く
+
+  # blockquote
+  成長したいなら、それも早く成長したいなら、すごい人と一緒になれる環境
+  に行きたいとか言っていちゃ遅いと思うんだ。
+
+  一緒にいるだけじゃそんなに変わらないよ。
+
+  同じ場所で一緒に同じものを作って、振りきられないように食い下がって付
+  いていくぐらいじゃないとどこでやったって同じだよ。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/27342986390'))
+
+= 自分が動く\n(('note:(YOU do it)'))
+
+  # blockquote
+  すごい人と一緒になれる環境に行きたいとか言っていちゃ遅いと思うんだ。
+
+  一緒にいるだけじゃそんなに変わらないよ。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/27342986390'))
+
+= 自分が動く\n(('note:(YOU do it)'))
+
+  # blockquote
+
+  同じ場所で一緒に同じものを作って、振りきられないように食い下がって付
+  いていくぐらいじゃないとどこでやったって同じだよ。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/27342986390'))
+
+= 書く\n(('note:(Write)'))
+
+  # blockquote
+  本を読んでるだけじゃいいコードは書けるようにならないよ。
+
+  実際にコードを書かないとわからないことがたくさんある。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/222338170811977729'))
+
+= リーダブルコードの解説
+
+  (1) 実際にやる(('note:(Do it)'))
+      * 書く(('note:(Write)'))
+  (2) 当たり前にする(('note:(Make natural)'))
+      * ((*書く・読む*))(('note:(Write and Read)'))
+  (3) コードで伝える(('note:(Communicate by code)'))
+      * 書く・読む・書く(('note:(Write, Read and Write)'))
+
+= 書く\n(('note:(Write)'))
+
+  # blockquote
+  まわりのコードが汚くたって、自分も汚いコードを書いていい理由にはなら
+  ないんだよ。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/10565574631'))
+
+= 困ったら\n(('note:(If you get a trouble)'))
+
+  # blockquote
+  ふつうにコードを書いているとき、1時間に1回もコミットできなかったらそ
+  れは異常な状態だよね。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/180249583304183808'))
+
+= 相談する\n(('note:(Talk)'))
+
+  # blockquote
+  だれかに相談するとか気分転換するとか方向性を変えてみるとかした方がい
+  いよね。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/180249583304183808'))
+
+= 読む\n(('note:(Read)'))
+
+  # blockquote
+  お前ら、いいコードを書けるようになりたいんだったら、
+  少なくとも自分が関わっている
+  プロジェクトのコミットくらい全部読めよ！
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/195137471057633281'))
+== メモ
+
+  * レビュー依頼されたときだけ読むの？
+
+= レビュー\n(('note:(Review)'))
+
+  * 間違いをいれないため？\n
+    (('note:(Is it for blocking wrong codes?)'))
+  * 批判的な目で読む？\n
+    (('note:(I can't translate it... :<)'))
+  * 言われてやるもの？\n
+    (('note:(I can't translate it... :<)'))
+
+= コードを読むこと\n(('note:(Reading code)'))
+
+もっとたのしいものじゃないの？\n
+(('note:(Is it jolyful, isn't it?)'))
+
+  * この書き方知らなかった！\n
+    いいなぁ！真似しよう！\n
+    (('note:(Wow! I didn't know the feature! I'll use it!)'))
+  * おぉ！\n
+    この機能欲しかったんだよ！\n
+    (('note:(Cool! I realy like the new feature!)'))
+
+= リーダブルコードの解説
+
+  (1) 実際にやる(('note:(Do it)'))
+      * 書く(('note:(Write)'))
+  (2) 当たり前にする(('note:(Make natural)'))
+      * 書く・読む(('note:(Write and Read)'))
+  (3) コードで伝える(('note:(Communicate by code)'))
+      * ((*書く・読む・書く*))(('note:(Write, Read, Write)'))
+
+= 書く\n(('note:(Write)'))
+
+  # blockquote
+  私たちができることはコードを書くこと。
+
+  コードを通じて伝えられることは多いよ。
+
+  そんな当たり前のことを当たり前のように思い出した。
+
+(('tag:center'))
+(('note:札幌Ruby会議02に行ってみて初心に帰った'))\n
+(('note:http://adzuki34.blogspot.jp/2009/12/ruby02.html'))
+
+= 書く\n(('note:(Write)'))
+
+  # blockquote
+  コードを書いているだけで人に影響を与えることができる人っているんだよ。
+
+(('tag:center'))
+(('note:札幌Ruby会議02に行ってみて初心に帰った'))\n
+(('note:http://adzuki34.blogspot.jp/2009/12/ruby02.html'))
+
+= リーダブルコードの解説
+
+  (1) 実際にやる(('note:(Do it)'))
+      * 書く(('note:(Write)'))
+  (2) 当たり前にする(('note:(Make natural)'))
+      * 書く・読む(('note:(Write and Read)'))
+  (3) コードで伝える(('note:(Communicate by code)'))
+      * 書く・読む・書く(('note:(Write, Read and Write)'))
+
+(('tag:center'))
+(('note:http://www.clear-code.com/blog/2012/6/11.html'))
+
+= 解説へのコメント
+  # blockquote
+  読んだだけでその気になって終わらせるな。
+
+  世界を変えたいなら自分を変えろ。諦めることを拒み続けろ。
+
+  小さくとも具体的な行動をしろ。それはこうすることだ。
+
+(('tag:center'))
+# (('note:id:habuakihiroのブクマコメント'))\n
+(('note:http://b.hatena.ne.jp/habuakihiro/20120701#bookmark-97498594'))
+
+= 道\n(('note:(Load)'))
+
+  # blockquote
+  よいプログラマへの道を歩き出したのなら、ともにその道を歩くものだと思っ
+  ています。
+
+  育ててあげるという考え方はやめることにしました。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/6464335060'))
+
+= 期待する世界\n(('note:(Expected world)'))
+
+  # blockquote
+  そうか、キレイなコードを書くことが当たり前の世界になって欲しいのかも
+  しれない。
+
+(('tag:center'))
+(('note:https://twitter.com/ktou/status/170661011152572416'))
+
+= クリアなコードの作り方\n(('note:(How to make clear code)'))
+
+(('wait'))
+We Code.\n
+Period.\n
+(('note:（以上）'))

metadata

@@ -0,0 +1,98 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-sprk2012
+version: !ruby/object:Gem::Version
+  version: 2012.09.16
+  prerelease: 
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-09-14 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: rabbit-theme-clear-code
+  requirement: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    none: false
+    requirements:
+    - - ! '>='
+      - !ruby/object:Gem::Version
+        version: '0'
+description: ! '私はコードを書くことが好きです。もっと言うとクリアなコードを書くことが
+
+  好きです。クリアなコードを書くことはとても楽しいので、みんながクリアな
+
+  コードを書けるようになればいいなぁと思っています。そこで、私がどうやっ
+
+  てクリアなコードを書いているかを紹介します。
+
+  I like coding. I say more. I like coding clear code. I hope that we
+
+  can code clear code because coding clear code is very fun. I''ll talk
+
+  about how I code clear code.'
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .rabbit
+- config.yaml
+- Rakefile
+- COPYING
+- README.rd
+- readable-code.jpeg
+- how-to-make-clear-code.rab
+- pdf/sprk2012-how-to-make-clear-code.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/sprk2012/
+licenses:
+- CC BY-SA 3.0
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  none: false
+  requirements:
+  - - ! '>='
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 1.8.23
+signing_key: 
+specification_version: 3
+summary: クリアなコードの作り方 - How to make clear code
+test_files: []