rabbit-slide-kou-readable-code-workshop-2015-06-24-implementation 2015.6.24.0

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA1:
+  metadata.gz: abcf94ad2f2897d8855053171108f5f40704c184
+  data.tar.gz: 74380ec59c20a63413da7d446d8acae5ae561ac4
+SHA512:
+  metadata.gz: 3f15fa42f18946517eabcbaf150758cea903dab16df5b1db89c350a3585a0de892b6a4e566609bb323346464dc34be3d022339ebe957182c74c1d5cef6a22301
+  data.tar.gz: 5c32c5d2386ea345f1b63f225df20581ef89f7204b1ed2ab5aa408b597b342dfde9746ef6b04e25b749276885a6d834d10b2bae0ffcf0114ea53c2a9ddb4df97

data/.rabbit

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

data/README.rd

@@ -0,0 +1,32 @@
+= 実践リーダブルコード - 課題の実装の進め方
+
+2015-06-24開催の実践リーダブルコードで実装する課題の概要と進め方の説明。
+
+== ライセンス
+
+CC BY-SA 4.0
+
+原著作者名は以下の通りです。
+
+  * 株式会社クリアコード
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-readable-code-workshop-2015-06-24-implementation
+
+=== 表示
+
+  rabbit rabbit-slide-kou-readable-code-workshop-2015-06-24-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-06-24-implementation
+base_name: how-to-proceed
+tags:
+- rabbit
+- readable-code
+presentation_date: 2015-06-24
+version: 2015.6.24.0
+licenses:
+- CC BY-SA 4.0
+slideshare_id: readable-code-workshop-2015-06-24-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,110 @@
+= 課題の実装の進め方
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   実践リーダブルコード
+: date
+   2015-06-24
+: allotted-time
+   5m
+: theme
+   clear-code
+
+= 実装する目的
+
+(('tag:center'))
+午後の作業の布石\n
+↓
+
+  * 課題の仕様を理解するため
+  * 読まれることを意識して\n
+    書かれたコードを用意するため
+    * リーダブルなコードを書いて！
+
+= 目的じゃないこと
+
+  * テクニックをたくさん覚える
+  * 難しいプログラムでも\n
+    実装できるようになる
+  * 速く実装できるようになる
+
+= 課題の傾向
+
+  * 技術的に難しいことは\n
+    意図的に避けている
+  * 段階的に改良していく
+  * 時間内で実装しきれない分量
+    * ((*すべて実装する必要はない！*))
+
+= メモを書く
+
+  * 工夫したことはissueに書く
+    * 1つのissueに1つの工夫でOK
+  * メモに含めること
+    * 実際のコードの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
+
+  * チューターに相談
+    * チューターは((*答えを教えない*))
+    * 一緒に考えてくれる
+  * 答えを教えない理由
+    * 参加者が考える機会を奪わないため
+    * 一緒に考えると新しい視点が増える
+
+= 困ったら2
+
+  * まわりの参加者に相談
+    * 答えを教えてもよい
+    * 一緒に考えてもよい
+  * 条件
+    * 答えを教えるときは理由も伝える\n
+      (('note:（教える参加者が考える機会になる！）'))
+    * 聞く人は理由も聞く\n
+      (('note:（考え方を知ると新しい視点でコードを読める！）'))
+
+= 実装開始
+
+  * 仕様
+    * task.md
+  * 練習
+    * 講師がtask.mdを読んで説明
+    * 仕様1をみんなで実装
+    * 実装できたら休憩→仕様2以降実装
+

metadata

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