rabbit-slide-kou-readable-code-workshop-2015-03-06-implementation 2015.3.6.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: e35d09e9193a7f7070c2b68c2a2c629e3adf708d
+  data.tar.gz: 239ed55aa6ab3567f92e79811e5ef30eb0252008
+SHA512:
+  metadata.gz: 39a8bdc6d77c841954773a89e1bf9c770ecc0a821a12c6a3765699199d561733dc8770733b5a9698f52428164ee9aaf19e33ba119cdca4d8345d033a80c61663
+  data.tar.gz: 27ef9d87cbf2e8ff0f1634348da8370ab5d232e37d501cb2a0b2af2ff9b25cc46763c7a69c445691b48378a9d33b680d0a8b5696dcdb9589ed636f852d8e8fe6

data/.rabbit

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

data/README.rd

@@ -0,0 +1,32 @@
+= 実践リーダブルコード - 課題の実装の進め方
+
+2015-03-06開催の実践リーダブルコードで実装する課題の概要と進め方の説明。
+
+== ライセンス
+
+CC BY-SA 4.0
+
+原著作者名は以下の通りです。
+
+  * 株式会社クリアコード
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-readable-code-workshop-2015-03-06-implementation
+
+=== 表示
+
+  rabbit rabbit-slide-kou-readable-code-workshop-2015-03-06-implementation.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
+  # spec.files += Dir.glob("doc/**/*.*")
+  # spec.files -= Dir.glob("private/**/*.*")
+  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,22 @@
+---
+id: readable-code-workshop-2015-03-06-implementation
+base_name: how-to-proceed
+tags:
+- rabbit
+- readable-code
+presentation_date: 2015-03-06
+version: 2015.3.6.0
+licenses:
+- CC BY-SA 4.0
+slideshare_id: readable-code-workshop-2015-03-06-implementation
+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,104 @@
+= 課題の実装の進め方
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   実践リーダブルコード
+: date
+   2015-03-06
+: allotted-time
+   5m
+: theme
+   clear-code
+
+= 実装する目的
+
+(('tag:center'))
+午後の作業の布石\n
+↓
+
+  * 課題の仕様を理解するため
+  * 読まれることを意識して\n
+    書かれたコードを用意するため
+    * リーダブルなコードを書いて！
+
+= 目的じゃないこと
+
+  * テクニックをたくさん覚える
+  * 難しいプログラムでも\n
+    実装できるようになる
+  * 速く実装できるようになる
+
+= 課題の傾向
+
+  * 技術的に難しいことは\n
+    意図的に避けている
+  * 段階的に改良していく
+  * 時間内で実装しきれない分量
+    * ((*すべて実装する必要はない！*))
+
+= 練習としてやること
+
+仕様1を実装\n
+(('note:進め方の詳細はtask.mdを参照'))
+
+= メモ
+
+  * 工夫したことはmemo.mdに書く
+  * memo.mdはリポジトリーにpush
+  * ↓を含める
+    * 実際のコードのURL
+    * リーダブルな理由
+
+= メモ例
+
+  # _
+  ## 統一されたスタイル ← リーダブルな書き方の名前
+
+  URL: https://github.com/kou/.../commit/eb02be
+
+  コード:
+  @@ -64,7 +64,7 @@ void add_recipe_to_RecipeList(...) {
+   void open_RecipeList(RecipeList *list, char *path) {
+     FILE *fp;
+     /* ファイルを開く */
+  -  if ((fp = fopen(path , "r")) == NULL){
+  +  if ((fp = fopen(path , "r")) == NULL) {
+       fprintf (stderr, "ファイルが開けません\n");
+       fclose(fp);
+       exit(EXIT_FAILURE);
+
+  理由:
+  ファイル内でスタイルを統一しているので読みやすくなっている。
+
+= リーダブルコードとは
+
+  * 読む人基準
+    * 「読む人」が　読みやすいなら\n
+      リーダブル
+  * 読む人の視点を意識してみて
+    * どんな人が読む？
+    * どんな前提知識がある？
+
+= 困ったら1
+
+  * チューターに相談
+    * チューターは((*答えを教えない*))
+    * 一緒に考えてくれる
+  * なんで！？答えを教えてよ！
+    * 講師が禁止している\n
+      (('note:（参加者が考える機会を奪わないため）'))
+    * チューターは意地悪ではない
+
+= 困ったら2
+
+  * まわりの参加者に相談
+    * 答えを教えてもよい
+    * 一緒に考えてもよい
+  * 条件
+    * 答えを教えるときは理由も伝える\n
+      (('note:（教える参加者が考える機会になる！）'))
+    * 聞く人は理由も聞く\n
+      (('note:（考え方を知ると新しい視点でコードを読める！）'))

metadata

@@ -0,0 +1,78 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-readable-code-workshop-2015-03-06-implementation
+version: !ruby/object:Gem::Version
+  version: 2015.3.6.0
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-03-06 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-03-06開催の実践リーダブルコードで実装する課題の概要と進め方の説明。
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- how-to-proceed.rab
+- pdf/readable-code-workshop-2015-03-06-implementation-how-to-proceed.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/readable-code-workshop-2015-03-06-implementation/
+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: "実践リーダブルコード - 課題の実装の進め方"
+test_files: []