rabbit-slide-kou-sezemi-2015-readable-code-exercise 2015.6.6.1

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: d64bdd0fd10d9d01bfb5463fd7d67b3044aba966
+  data.tar.gz: 9e944a94ec09e5d7cae8cae905e76b0228bc3817
+SHA512:
+  metadata.gz: d70a13267bdb226ef4a6e085f42dc6d806edd49a6f5371945d47dd8e98570e34e9c44bce888bffd389e3bc37e26b03ca0f13894d47f4ccd887ccbd2efa4c20bb
+  data.tar.gz: 5078357dc5e1e4feba730da790a3c2ff49cc139608205a31b0e94961c14b8b4c654d74bb8bf8ddd98f9d956ecc6fae8955a1eb85f2b54abaecbe0cdbf8e014e6

data/.rabbit

@@ -0,0 +1 @@
+how-to-proceed.rab

data/README.rd

@@ -0,0 +1,33 @@
+= SEゼミ2015 - 練習
+
+2015年のSEゼミの「プログラミングが好きな学生のためのリーダブルコード勉
+強会」の課題の進め方を練習する方法の説明。
+
+== ライセンス
+
+CC BY-SA 4.0
+
+原著作者名は以下の通りです。
+
+  * 株式会社クリアコード
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-sezemi-2015-readable-code-exercise
+
+=== 表示
+
+  rabbit rabbit-slide-kou-sezemi-2015-readable-code-exercise.gem
+

data/Rakefile

@@ -0,0 +1,17 @@
+require "rabbit/task/slide"
+
+# Edit ./config.yaml to customize meta data
+
+spec = nil
+Rabbit::Task::Slide.new do |task|
+  spec = task.spec
+  # task.spec.files += Dir.glob("doc/**/*.*")
+  # task.spec.files -= Dir.glob("private/**/*.*")
+  task.spec.add_runtime_dependency("rabbit-theme-clear-code")
+end
+
+desc "Tag #{spec.version}"
+task :tag do
+  sh("git", "tag", "-a", spec.version.to_s, "-m", "Publish #{spec.version}")
+  sh("git", "push", "--tags")
+end

data/config.yaml

@@ -0,0 +1,23 @@
+---
+id: sezemi-2015-readable-code-exercise
+base_name: how-to-proceed
+tags:
+- rabbit
+- readable-code
+- sezemi
+presentation_date: 2015-06-06
+version: 2015.6.6.1
+licenses:
+- CC BY-SA 4.0
+slideshare_id: sezemi-2015-readable-code-exercise
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+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-proceed.rab

@@ -0,0 +1,128 @@
+= 練習の仕方
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   SEゼミ2015 - リーダブルコード勉強会
+: date
+   2015-06-06
+: allotted-time
+   5m
+: theme
+   clear-code
+
+= 課題が目指すこと
+
+(('tag:center'))
+(('tag:large'))
+(('tag:margin-bottom'))
+↓を体験する
+
+  * コードを読んで
+  * リーダブルコードを((*見つける*))
+  * ↑を活かしてコードを書く
+
+= 課題が目指さないこと
+
+  * テクニックをたくさん((*覚える*))
+  * 難しいプログラムでも\n
+    実装できるようになる
+  * 速く実装できるようになる
+
+= 課題の傾向
+
+  * 技術的に難しいことは\n
+    意図的に避けている
+  * 段階的に改良していく
+  * 時間内で実装しきれない分量
+    * ((*すべて実装する必要はない！*))
+
+= 練習としてやること
+
+(('tag:center'))
+(('tag:x-large'))
+仕様1を実装\n
+(('note:進め方の詳細はtask.mdを参照'))\n
+(('note:https://github.com/clear-code/sezemi-2015/から辿れる'))
+
+(('tag:margin-top'))
+(('tag:margin-top'))
+(('note:メンター：参加者がtask.mdを見つけられるようにサポート'))\n
+(('note:メンター：見つけられたら教えて'))
+
+= メモ
+
+  * 課題は精一杯の\n
+    リーダブルコードで実装する
+  * リーダブルポイントをメモする
+    * メモはリポジトリーにpush
+    * 書き方は後述
+    * コードを交換した相手も読むよ！
+
+= リーダブルコードとは
+
+  * 読む人基準
+    * 読む人が\n
+      読みやすいなら\n
+      リーダブル
+  * 読む人の視点を意識してみて
+    * どんな人が読む？
+    * どんな前提知識がある？
+
+= 困ったら1
+
+  * メンターに相談
+    * メンターは((*答えを教えない*))
+    * 一緒に考えてくれる
+  * なんで！？答えを教えてよ！
+    * トレーナーが禁止している\n
+      (('note:（参加者が考える機会を奪わないため）'))
+    * メンターは意地悪ではない
+
+(('note:メンターへ：新しい視点に導いてあげてください'))
+
+= 困ったら2
+
+  * まわりの参加者に相談
+    * 答えを教えてもよい
+    * 一緒に考えてもよい
+  * ヒント
+    * 答えを教えるときは理由も伝える\n
+      (('note:（教える参加者が考える機会になる！）'))
+    * 聞く人は理由も聞く\n
+      (('note:（考え方を知ると新しい視点でコードを読める！）'))
+
+= 困ったら3
+
+  * 他の参加者のコードを見る
+    * コードから学ぶ！
+    * この勉強会で大事にしていること
+  * ヒント
+    * 参考にするときは理由を考える
+    * どうしてこのコードがリーダブル？
+    * メモに書こう
+
+= 課題1が終わったら
+
+  * メンターに確認依頼
+    * →OKなら各自休憩
+  * 休憩後
+    * task.mdを最初から読み直す
+    * 読み直したら課題2以降を進める
+    * 随時メモを書こう！
+
+(('note:メモ：task.mdにあるメモの書き方例を紹介することを忘れない'))
+
+= …課題実装中…
+
+  * 今の自分の精一杯の\n
+    リーダブルコードを書こう
+  * ↑をmemo.mdにメモろう
+    * 実際のコード・説明・一言説明
+    * 例はtask.md参照
+
+(('note:メンターへ：メビューで使うのでメンターもメモろう'))
+
+(('note:メンターへ：たまに「どんなメモ書いた？」と聞いて課題をこなすことではなくリーダブルコードを書くことに参加者の注意を向けてみよう'))

metadata

@@ -0,0 +1,80 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-sezemi-2015-readable-code-exercise
+version: !ruby/object:Gem::Version
+  version: 2015.6.6.1
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-06-05 00:00:00.000000000 Z
+dependencies:
+- !ruby/object:Gem::Dependency
+  name: rabbit
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: 2.0.2
+- !ruby/object:Gem::Dependency
+  name: rabbit-theme-clear-code
+  requirement: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+  type: :runtime
+  prerelease: false
+  version_requirements: !ruby/object:Gem::Requirement
+    requirements:
+    - - ">="
+      - !ruby/object:Gem::Version
+        version: '0'
+description: |-
+  2015年のSEゼミの「プログラミングが好きな学生のためのリーダブルコード勉
+  強会」の課題の進め方を練習する方法の説明。
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- how-to-proceed.rab
+- pdf/sezemi-2015-readable-code-exercise-how-to-proceed.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/sezemi-2015-readable-code-exercise/
+licenses:
+- CC BY-SA 4.0
+metadata: {}
+post_install_message: 
+rdoc_options: []
+require_paths:
+- lib
+required_ruby_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+required_rubygems_version: !ruby/object:Gem::Requirement
+  requirements:
+  - - ">="
+    - !ruby/object:Gem::Version
+      version: '0'
+requirements: []
+rubyforge_project: 
+rubygems_version: 2.2.2
+signing_key: 
+specification_version: 4
+summary: SEゼミ2015 - 練習
+test_files: []