rabbit-slide-kou-devlove-2012 2012.12.16.0

data/.rabbit

@@ -0,0 +1 @@
+after-reading-readable-code.rab

data/README.rd

@@ -0,0 +1,28 @@
+= リーダブルコードを読んだ後
+
+DevLOVE 2012での「リーダブルコードを読んだ後」というセッションで説明のために使ったスライドです。セッションの内容は、リーダブルコードに書かれていることを実際に使うためにはどうすればよいかということを実際にやってみるというものです。ワークショップ形式のセッションです。
+
+リーダブルコードという読みやすいコード（リーダブルなコード）の書き方をわかりやすく説明した本があります。リーダブルコードに書かれているテクニックを使えばリーダブルな理解しやすいコードを書けるようになります。
+
+しかし、リーダブルコードを読んだ人すべてがリーダブルなコードを書けるようになれるわけではありません。リーダブルコードに書かれていることを知識として持っているだけではリーダブルなコードは書けません。実際にその知識を使ってコードを書かなければリーダブルコードを読む前と同じようなコードばかり書くことになります。
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-devlove-2012
+
+=== 表示
+
+  rabbit rabbit-slide-kou-devlove-2012.gem
+

data/Rakefile

@@ -0,0 +1,24 @@
+# Copyright (C) 2012  Kouhei Sutou <kou@clear-code.com>
+#
+# 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"
+
+# Edit ./config.yaml to customize meta data
+
+Rabbit::Task::Slide.new do |task|
+  task.spec.add_runtime_dependency("rabbit-theme-clear-code")
+end

data/after-reading-readable-code.rab

@@ -0,0 +1,261 @@
+= リーダブルコードを\n読んだ後
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   DevLOVE 2012
+: date
+   2012/12/16
+: allotted-time
+   10m
+: theme
+   clear-code
+
+= やること
+
+クリアコードの開発方法を体験
+
+= 目標
+
+(('tag:center'))(('tag:large'))リーダブルコードを
+
+(('tag:center'))(('tag:x-large'))当たり前にする
+
+= イベントのテーマ
+
+  # image
+  # src = http://devlove2012.devlove.org/theme/jobs/images/copy.png
+  # relative_width = 100
+
+== スライドプロパティ
+
+: enable-title-on-image
+   false
+
+= 目標
+
+(('tag:center'))(('tag:x-large'))あなたが
+
+(('tag:center'))(('tag:large'))リーダブルコードを
+
+(('tag:center'))(('tag:x-large'))当たり前にする
+
+= やり方
+
+  * クリアコードの開発方法を体験
+  * 対象:野生のフリーソフトウェア
+  * 読む人を「想像」しない
+  * 読む人を「思い出す」
+
+= 想像上の誰か
+
+  # blockquote
+  # title = リーダブルコード 1.5 でもやるんだよ
+
+  想像上の誰かが自分のコードを理解しやすいかなんて考えるのは大変なことだ。
+
+= 想像しない
+
+  * 読む人を「想像」しない
+  * 読む人を「思い出す」
+
+= 思い出すには？
+
+読む人になる
+
+= クリアコードの開発方法
+
+  * コミットメールが全員に届く\n
+    (('note:（diff入り）'))
+    * 全員が読む
+  * 気になったらコメント\n
+    (('note:（プロジェクト外の人でも）'))
+  * 「昨日印象に残ったコミット」を朝会で報告
+
+= ポイント
+
+  * 全員が書く人で読む人
+  * 書く時:
+    * 読む時の事を思いながら\n
+      (('note:（こう書くと読みやすいんだよな。）'))
+  * 読む時:
+    * 書く時の事を思いながら\n
+      (('note:（これ読みやすいから今度同じように書こう。）'))
+
+= 当日は省略
+
+= なぜリーダブルコード？
+
+開発を\n続けるため
+
+= メリット
+
+  * メンテナンスコストを低く保つ\n
+    (('note:（開発を続けるわりにあわなくなってしまう）'))
+  * 機能追加・変更をしやすくする\n
+    (('note:（使われないものになって開発する必要がなくなる）'))
+  * プログラマーの意欲を保つ\n
+    (('note:（プログラマーも人です）'))
+
+= 注意
+
+  * すべてを解決するわけではない
+    * よりよくする重要な方法の1つ
+  * トレードオフ
+
+= メンテナンスコスト
+
+  # blockquote
+
+  メンテナンスコストを低く保つためにずっとリファクタリングをし続ける
+  と…高いメンテナンスコスト
+
+= 素早い変更
+
+  # blockquote
+
+  素早く機能追加・変更できるよう、リーダブルコードにするために必要な時
+  間を確保して開発しているのに、機能を追加したいというと必ず1週間以上は
+  必要だと言われる…素早くない変更
+
+= ゴール
+
+  * 本末転倒にならないように！
+  * リーダブルコードを書くことは\n
+    ゴールじゃない
+    * 効率よく目的を実現するのがゴール\n
+      (('note:（今だけ効率がよければよいのではない。念のため。）'))
+  * 手早くリーダブルコードを\n
+    書けるようになろう！
+
+= なぜコミットメール？
+
+ペアプロより\n
+スケールする
+
+= ペアプロ
+
+  * 常にコードレビュー
+  * 2人だけ
+  * 時間をあわせる
+  * 距離をあわせる
+  * プロジェクトをあわせる
+
+= コミットメール
+
+  * 常にコードレビュー
+  * 2人以上も読める
+  * 時間がずれてもよい
+  * 距離がずれてもよい
+  * プロジェクトがずれてもよい
+
+= コミット
+
+(('tag:center'))(('tag:large'))(('tag:margin-bottom'))
+ペアプロしているように！
+
+  * 小さくコミット
+  * 意図が伝わるコミット
+
+= ペアプロの方がよいこと
+
+(('tag:center'))(('tag:large'))(('tag:margin-bottom'))
+全体の設計とかもみれる
+
+  * コミットメールだけだとムリ
+  * pull requestだけでもムリ
+  * 一緒に書いていないとムリ\n
+    (('note:（同じプロジェクトだといけそう）'))
+
+= ここまで飛ばす
+
+= 確認
+
+事前課題
+
+= 事前課題
+
+  (1) リーダブルコードを読む
+  (2) Rubyコードの感想戦を読む
+  (3) github://clear-code/git-utilsをfork
+  (4) commit-email.rbを読む
+      * Rubyコードの感想戦のように読む
+
+= 事前課題確認1
+
+  (1) ((*リーダブルコードを読む*))
+  (2) Rubyコードの感想戦を読む
+  (3) github://clear-code/git-utilsをfork
+  (4) commit-email.rbを読む
+      * Rubyコードの感想戦のように読む
+
+= 事前課題確認2
+
+  (1) リーダブルコードを読む
+  (2) ((*Rubyコードの感想戦を読む*))
+  (3) github://clear-code/git-utilsをfork
+  (4) commit-email.rbを読む
+      * Rubyコードの感想戦のように読む
+
+= 事前課題確認3
+
+  (1) リーダブルコードを読む
+  (2) Rubyコードの感想戦を読む
+  (3) ((*github://clear-code/git-utilsをfork*))
+  (4) commit-email.rbを読む
+      * Rubyコードの感想戦のように読む
+
+= 事前課題確認4
+
+  (1) リーダブルコードを読む
+  (2) Rubyコードの感想戦を読む
+  (3) github://clear-code/git-utilsをfork
+  (4) ((*commit-email.rbを読む*))
+      * Rubyコードの感想戦のように読む
+
+= むずかしい？
+
+  * 「うまくできない」は今のうち
+  * 聞けば答えます
+
+= 進め方
+
+  * 読み手になる: 15分
+    * (('note:事前課題をやっていない人: Rubyコードの感想戦を読む'))
+  * 読み手目線で書く: 15分
+    * (('note:事前課題をやっていない人: 読み手になる'))
+  * 質疑応答: 10分
+
+= 読み手になる: 15分
+
+  (1) 数人のグループを作る
+  (2) グループ用のgit-utilsをclone
+  (3) 読んでcommit & push
+      * リーダブルなら理由をコメントとして書く
+      * リーダブルじゃないなら直してコミットメッセージで((*理由*))を説明
+
+= 読み手目線で書く: 15分
+
+  (1) 他のグループのリポジトリのコミットを確認\n
+      (('note:コミットメールが届いているはず'))
+      * 自分達にピンとこないものを選ぶ
+      * 直してメッセージで((*理由*))を説明
+      * コードで伝える
+  (2) 自分たちのリポジトリを確認
+  (3) 繰り返す
+
+= 質疑応答: 10分
+
+  * 気になったコミットは？
+  * やってみて困ったことは？
+  * 実践すると困りそうなことは？
+
+= 宣伝
+
+(('tag:center:コミットへのコメントサービス'))
+
+  「リーダブルコードの解説 - ククログ(2012-06-11)」
+  http://www.clear-code.com/blog/2012/6/11.html
+  ↑の一番最後のところ

data/config.yaml

@@ -0,0 +1,23 @@
+---
+id: devlove-2012
+base_name: after-reading-readable-code
+tags:
+- rabbit
+- readablecode
+- devlove
+- devlove2012
+presentation_date: 2012/12/16
+version: 2012.12.16.0
+licenses:
+- CC BY-SA 3.0
+slideshare_id: 
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+author:
+  markup_language: :rd
+  name: 須藤功平
+  email: kou@clear-code.com
+  rubygems_user: kou
+  slideshare_user: kou
+  speaker_deck_user: kou

metadata

@@ -0,0 +1,84 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-devlove-2012
+version: !ruby/object:Gem::Version
+  version: 2012.12.16.0
+  prerelease: 
+platform: ruby
+authors:
+- 須藤功平
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2012-12-11 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: DevLOVE 2012での「リーダブルコードを読んだ後」というセッションで説明のために使ったスライドです。セッションの内容は、リーダブルコードに書かれていることを実際に使うためにはどうすればよいかということを実際にやってみるというものです。ワークショップ形式のセッションです。
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- .rabbit
+- config.yaml
+- Rakefile
+- README.rd
+- after-reading-readable-code.rab
+- pdf/devlove-2012-after-reading-readable-code.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/devlove-2012/
+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: リーダブルコードを読んだ後
+test_files: []