rabbit-slide-kou-readable-code-workshop-for-pioneer-conclusion 2015.8.11.0

data/images/readable-code-reasonability.svg

@@ -0,0 +1,167 @@
+<?xml version="1.0" encoding="UTF-8" standalone="no"?>
+<!-- Created with Inkscape (http://www.inkscape.org/) -->
+
+<svg
+   xmlns:dc="http://purl.org/dc/elements/1.1/"
+   xmlns:cc="http://creativecommons.org/ns#"
+   xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
+   xmlns:svg="http://www.w3.org/2000/svg"
+   xmlns="http://www.w3.org/2000/svg"
+   xmlns:sodipodi="http://sodipodi.sourceforge.net/DTD/sodipodi-0.dtd"
+   xmlns:inkscape="http://www.inkscape.org/namespaces/inkscape"
+   width="416.15005"
+   height="233.13203"
+   id="svg2"
+   version="1.1"
+   inkscape:version="0.48.5 r10040"
+   sodipodi:docname="readable-code-reasonability.svg">
+  <defs
+     id="defs4">
+    <marker
+       inkscape:stockid="Arrow1Lend"
+       orient="auto"
+       refY="0"
+       refX="0"
+       id="Arrow1Lend"
+       style="overflow:visible">
+      <path
+         id="path3764"
+         d="M 0,0 5,-5 -12.5,0 5,5 0,0 z"
+         style="fill-rule:evenodd;stroke:#000000;stroke-width:1pt"
+         transform="matrix(-0.8,0,0,-0.8,-10,0)"
+         inkscape:connector-curvature="0" />
+    </marker>
+  </defs>
+  <sodipodi:namedview
+     id="base"
+     pagecolor="#ffffff"
+     bordercolor="#666666"
+     borderopacity="1.0"
+     inkscape:pageopacity="0.0"
+     inkscape:pageshadow="2"
+     inkscape:zoom="1.979899"
+     inkscape:cx="304.97745"
+     inkscape:cy="179.2249"
+     inkscape:document-units="px"
+     inkscape:current-layer="layer1"
+     showgrid="false"
+     inkscape:window-width="1237"
+     inkscape:window-height="817"
+     inkscape:window-x="2116"
+     inkscape:window-y="68"
+     inkscape:window-maximized="0"
+     fit-margin-top="10"
+     fit-margin-left="10"
+     fit-margin-right="10"
+     fit-margin-bottom="10" />
+  <metadata
+     id="metadata7">
+    <rdf:RDF>
+      <cc:Work
+         rdf:about="">
+        <dc:format>image/svg+xml</dc:format>
+        <dc:type
+           rdf:resource="http://purl.org/dc/dcmitype/StillImage" />
+        <dc:title></dc:title>
+      </cc:Work>
+    </rdf:RDF>
+  </metadata>
+  <g
+     inkscape:label="レイヤー 1"
+     inkscape:groupmode="layer"
+     id="layer1"
+     transform="translate(-42.823639,-264.5498)">
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow1Lend)"
+       d="m 62.629458,450.31127 286.883322,0"
+       id="path2985"
+       inkscape:connector-curvature="0" />
+    <path
+       style="fill:none;stroke:#000000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1;marker-end:url(#Arrow1Lend)"
+       d="m 104.04571,487.18183 0,-212.13203"
+       id="path2987"
+       inkscape:connector-curvature="0" />
+    <text
+       xml:space="preserve"
+       style="font-size:20px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="310.62192"
+       y="476.57526"
+       id="text4402"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan4404"
+         x="310.62192"
+         y="476.57526">時間</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans;-inkscape-font-specification:Sans"
+       x="52.022858"
+       y="293.73761"
+       id="text4406"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan4410"
+         x="52.022858"
+         y="293.73761">開発</tspan><tspan
+         sodipodi:role="line"
+         id="tspan4412"
+         x="52.022858"
+         y="318.73761">速度</tspan></text>
+    <path
+       style="fill:none;stroke:#a40000;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 104.02541,309.39499 c 0,0 15.15229,97.47972 90.40865,116.67261 75.25637,19.1929 140.91628,13.63706 140.91628,13.63706"
+       id="path5532"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="csc" />
+    <text
+       xml:space="preserve"
+       style="font-size:25px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#a40000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="174.97467"
+       y="387.88406"
+       id="text5534"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan5536"
+         x="174.97467"
+         y="387.88406">リーダブルじゃない場合</tspan></text>
+    <path
+       style="fill:none;stroke:#204a87;stroke-width:1px;stroke-linecap:butt;stroke-linejoin:miter;stroke-opacity:1"
+       d="m 103.57143,342.36218 c 0,0 63.28367,10.3815 101.53626,13.06635 43.48081,3.05182 112.03517,4.79079 132.74945,4.07651"
+       id="path5546"
+       inkscape:connector-curvature="0"
+       sodipodi:nodetypes="csc" />
+    <text
+       sodipodi:linespacing="125%"
+       id="text5548"
+       y="301.74121"
+       x="144.83182"
+       style="font-size:25px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#204a87;fill-opacity:1;stroke:none;font-family:Sans;-inkscape-font-specification:Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         id="tspan5552"
+         x="144.83182"
+         y="301.74121">リーダブルな場合</tspan></text>
+    <text
+       xml:space="preserve"
+       style="font-size:20px;font-style:normal;font-weight:normal;line-height:125%;letter-spacing:0px;word-spacing:0px;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans"
+       x="148.05447"
+       y="330.21933"
+       id="text5554"
+       sodipodi:linespacing="125%"><tspan
+         sodipodi:role="line"
+         id="tspan5556"
+         x="148.05447"
+         y="330.21933">開発速度が落ちにくい</tspan></text>
+    <text
+       sodipodi:linespacing="125%"
+       id="text5558"
+       y="412.21933"
+       x="177.2403"
+       style="font-size:20px;font-style:normal;font-variant:normal;font-weight:normal;font-stretch:normal;text-align:start;line-height:125%;letter-spacing:0px;word-spacing:0px;writing-mode:lr-tb;text-anchor:start;fill:#000000;fill-opacity:1;stroke:none;font-family:Sans;-inkscape-font-specification:Sans"
+       xml:space="preserve"><tspan
+         sodipodi:role="line"
+         id="tspan5562"
+         x="177.2403"
+         y="412.21933">開発速度が落ちやすい</tspan></text>
+  </g>
+</svg>

data/next-step.rab

@@ -0,0 +1,172 @@
+= まとめと次のステップ
+
+: author
+   須藤功平
+: institution
+   株式会社クリアコード
+: content-source
+   リーダブルコードワークショップ\n
+   （パイオニア向け）
+: date
+   2015-08-11
+: allotted-time
+   30m
+: theme
+   clear-code
+
+= 目的
+
+(('tag:center'))
+↓の方法を体験
+
+  # blockquote
+  ((*チームとして*))\n
+  リーダブルコードを書く
+
+= リーダブルコードの効果
+
+  * 既存コードの変更コスト↓
+    * 理解するまでの時間が短くなるから
+  * 既存コードの変更ミス↓
+    * 間違って理解しにくくなるから
+
+(('wait'))
+(('tag:center'))
+↓\n
+開発速度に影響
+
+= 変更コストと開発速度
+
+  # image
+  # src = images/readable-code-reasonability.svg
+  # relative_width = 90
+
+== プロパティー
+
+: enable-title-on-image
+   false
+
+= チームでリーダブルコード
+
+  * チームとしての開発速度↑
+    * 空いている人が対応できる
+  * メンバー交代コスト↓\n
+    （柔軟なチーム編成が可能）
+    * ○○さんが抜けても困らない
+    * 新しい人を受け入れられる
+
+= 実現方法
+
+チームでリーダブルコードを書く\n
+には…
+
+(('wait'))
+(('tag:center'))
+(('tag:large'))
+↓\n
+他メンバーのコードを読む
+
+(('wait'))
+(('tag:center'))
+それも！\n
+リーダブルコードを探す目線で
+
+= フィードバックループ
+
+  # image
+  # src = images/readable-code-feedback-loop.svg
+  # relative_height = 95
+
+== プロパティー
+
+: enable-title-on-image
+   false
+
+= うれしい副作用
+
+  # image
+  # src = images/readable-code-feedback-loop-side-effect.svg
+  # relative_height = 95
+
+== プロパティー
+
+: enable-title-on-image
+   false
+
+= 体験内容
+
+  * ((*個人として*))開発する
+  * ((*ペアとして*))開発する
+    * ペアのリーダブルコードを見つける\n
+      →共有
+  * ((*チームとして*))開発する
+    * 他メンバーのリーダブルコードを\n
+      見つける→共有
+
+= 体験した狙い
+
+(('tag:center'))
+(('tag:margin-bottom'))
+きっかけ作り
+
+  * よかったと実感
+    * 自分たちのチームに取り入れる
+    * そのままでもアレンジしてもよい
+  * そうでもなかった
+    * 「合わない」という知見が増えた😇
+
+= よかった場合向け
+
+参考情報紹介
+
+= リーダブルコードの伝え方
+
+  * (('wait'))Wikiに書く
+     * メモの書き方が参考になるはず
+  * (('wait'))コードで伝える
+    * 人のコードを読むチームならできる
+    * リーダブルコードをコミット！
+    * →他の人：「またこの書き方だ」
+    * →真似する人増加
+
+= コードを読む文化
+
+  * 新人の受け入れにも有用
+  * 人の入れ替えにも有用
+
+= どうして有用か
+
+(('tag:center'))
+(('tag:margin-bottom'))
+開発を通じて↓を伝えられる
+
+  * チームが大事にしていること
+    * チームのリーダブル
+    * チームの開発スタイル
+
+= コードを読む文化
+
+(('tag:center'))
+チームが大事にしていることを\n
+開発を通じて伝えられる\n
+↓
+
+  * 新人の受け入れにも有用
+    * 開発速度低下を抑えられる
+  * 人の入れ替えにも有用
+    * リーダブル見直しのよい機会
+
+= これからやること
+
+  * コミットメールを設定
+    * git-commit-mailer
+    * github-web-hooks-receiver
+  * 使っているOSSのコミットで練習
+    * commit-email.info
+
+= FAQ
+
+  * Q: コミットを読むコストが高い
+    * A1: コストを下げる方法を試す
+    * A2: メリットと天秤にかける\n
+      (('note:（自動テストと開発速度の関係と似ている）'))

metadata

@@ -0,0 +1,81 @@
+--- !ruby/object:Gem::Specification
+name: rabbit-slide-kou-readable-code-workshop-for-pioneer-conclusion
+version: !ruby/object:Gem::Version
+  version: 2015.8.11.0
+platform: ruby
+authors:
+- Kouhei Sutou
+autorequire: 
+bindir: bin
+cert_chain: []
+date: 2015-08-11 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: "リーダブルコードワークショップ（パイオニア向け）のまとめと次のステップの説明。"
+email:
+- kou@clear-code.com
+executables: []
+extensions: []
+extra_rdoc_files: []
+files:
+- ".rabbit"
+- README.rd
+- Rakefile
+- config.yaml
+- images/readable-code-feedback-loop-side-effect.svg
+- images/readable-code-feedback-loop.svg
+- images/readable-code-reasonability.svg
+- next-step.rab
+- pdf/readable-code-workshop-for-pioneer-conclusion-next-step.pdf
+homepage: http://slide.rabbit-shocker.org/authors/kou/readable-code-workshop-for-pioneer-conclusion/
+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: []