rabbit-slide-Piro-readable-code-workshop-2019-09-24-implementation 2019.09.24

checksums.yaml

@@ -0,0 +1,7 @@
+---
+SHA256:
+  metadata.gz: 9b9e07d6a02a146e3a4380a8ca2736183171f598506b8b459d50f090d9df583b
+  data.tar.gz: 1ac84278a87699b2febb3efa22528a07fd4c3650ea0139f96888fa64f03033cb
+SHA512:
+  metadata.gz: 8ca70cb24e8eac79222e3ea7effdaf121e47b86cd348a81941b5171a8cc14f069e538fa0ffcc668d0afbcc30de4a03e753beeede776e3f149ec33bd194265927
+  data.tar.gz: e0545ce8ac5ba51cd259acf9bab0fa5ee15e72748f990f29c7880349274e9b4c3894c12db2e61295f147f611c20fdc41537aa9b9761e75fa140fec49f834ab5f

data/.rabbit

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

data/README.rd

@@ -0,0 +1,32 @@
+= 実践リーダブルコード - 課題の実装の進め方
+
+2019-09-24開催の実践リーダブルコードで実装する課題の概要と進め方の説明。
+
+== ライセンス
+
+CC BY-SA 4.0
+
+原著作者名は以下の通りです。
+
+  * 株式会社クリアコード
+
+== 作者向け
+
+=== 表示
+
+  rake
+
+=== 公開
+
+  rake publish
+
+== 閲覧者向け
+
+=== インストール
+
+  gem install rabbit-slide-kou-readable-code-workshop-2019-09-24-implementation
+
+=== 表示
+
+  rabbit rabbit-slide-kou-readable-code-workshop-2019-09-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-2019-09-24-implementation
+base_name: how-to-proceed
+tags:
+- rabbit
+- readable-code
+presentation_date: 2019-09-24
+version: 2019.09.24
+licenses:
+- CC BY-SA 4.0
+slideshare_id: readable-code-workshop-2019-09-24-implementation
+speaker_deck_id: 
+ustream_id: 
+vimeo_id: 
+youtube_id: 
+author:
+  markup_language: :rd
+  name: YUKI Hiroshi
+  email: yuki@clear-code.com
+  rubygems_user: Piro
+  slideshare_user: pirooutsiderreflex
+  speaker_deck_user: piroor

data/how-to-proceed.rab

@@ -0,0 +1,110 @@
+= 課題の実装の進め方
+
+: author
+   結城洋志
+: institution
+   株式会社クリアコード
+: content-source
+   実践リーダブルコード
+: date
+   2019-09-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_term_to_TermList(...) {
+   void open_TermList(TermList *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-Piro-readable-code-workshop-2019-09-24-implementation
+version: !ruby/object:Gem::Version
+  version: 2019.09.24
+platform: ruby
+authors:
+- YUKI Hiroshi
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2019-09-20 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: 2019-09-24開催の実践リーダブルコードで実装する課題の概要と進め方の説明。
+email:
+- yuki@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- how-to-proceed.rab
+- pdf/readable-code-workshop-2019-09-24-implementation-how-to-proceed.pdf
+homepage: http://slide.rabbit-shocker.org/authors/Piro/readable-code-workshop-2019-09-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.7.6
+signing_key: 
+specification_version: 4
+summary: 実践リーダブルコード - 課題の実装の進め方
+test_files: []