Rabbit Slide Show

リーダブルコード勉強会 in 筑波大 - コードチェンジ

2015-07-04

Description

リーダブルコード勉強会 in 筑波大のコードチェンジのやり方の説明。

Text

Page: 1

コードチェンジ
須藤功平
株式会社クリアコード
リーダブルコード勉強会 in 筑波大
2015-07-04
コードチェンジ
Powered by Rabbit 2.1.7

Page: 2

目的の確認
リーダブルコードに関して
↓の2つを知る・体験する
✓ どういうコード?
✓ どうやって書くの?
コードチェンジ
Powered by Rabbit 2.1.7

Page: 3

知ったこと
✓ どういうコード?
✓ 読む人が読みやすいコード
✓ どうやって書くの?
✓ 読みやすかった経験を再現
コードチェンジ
Powered by Rabbit 2.1.7

Page: 4

やろうとしていること
1. コードを読んで
2. リーダブルコードを見つける
3. ↑を活かしてコードを書く
コードチェンジ
Powered by Rabbit 2.1.7

Page: 5

現状
1. 全員共通の課題を用意←Done
2. 課題を実装←Done
3. 実装を交換←これから
4. 交換した実装で開発継続
コードチェンジ
Powered by Rabbit 2.1.7

Page: 6

どうして交換するのか
✓ コードを読まざるを得なくなる
✓ コードを読まずに開発継続できない
✓ 自分も実装した仕様
✓ 仕様は理解済み→読む敷居は低い
✓ 違う視点での実装を読むことになる
✓ 新しい発見があるはず
コードチェンジ
Powered by Rabbit 2.1.7

Page: 7

やり方
✓ 交換相手を決める
✓ 交換相手のリポジトリーをfork
✓ ↑を使って開発継続
コードチェンジ
Powered by Rabbit 2.1.7

Page: 8

交換相手の決め方
✓ 基準
✓ だいたい同じ状況同士
✓ 例: 進み具合、環境
✓ メンターがヒアリング
✓ 積極的に協力して
コードチェンジ
Powered by Rabbit 2.1.7

Page: 9

リポジトリーをfork
デモして
見本を見せる
コードチェンジ
Powered by Rabbit 2.1.7

Page: 10

開発継続
✓ どこまで進んでいるかを確認
✓ READMEやlogを参考に
(どういう風に書いておけばよかったか考えてみて)
✓ ↑から開発を継続
コードチェンジ
Powered by Rabbit 2.1.7

Page: 11

忘れないで
✓ リーダブルコードを発見→メモ
✓ issueにコメント
✓ 書くこと
✓ 実際のコード
✓ リーダブルな理由
✓ 見つけたきっかけ
コードチェンジ
Powered by Rabbit 2.1.7

Page: 12

ポイント
悪いコードより
リーダブルな
コード
コードチェンジ
Powered by Rabbit 2.1.7

Page: 13

悪いコード
✓ 見つけやすい
✓ 異質
✓ リーダブルじゃない
✓ 過剰に指摘したくなる人がいる
✓ 指摘するならリーダブルなコードを
書いてPull Request
コミットメッセージによくなる理由を書く
例: https://github.com/BLThunder1991/
BLThunder1991-sezemi-2014-readable-code-2/pulls?
q=is%3Aclosed
コードチェンジ
Powered by Rabbit 2.1.7

Page: 14

リーダブルなコード
✓ 見つけにくい
✓ リーダブルだから
✓ すーっと理解できてひっかからない
✓ 今日のチャレンジ
✓ 意識して見つけよう!
コードチェンジ
Powered by Rabbit 2.1.7

Page: 15

発見方法のヒント
✓ リーダブルコード
✓ 読む人が
読みやすいなら
リーダブル
✓ 読む人視点が重要
✓ 交換直後の今が読む人の視点!
コードチェンジ
Powered by Rabbit 2.1.7

Page: 16

忘れないで
✓ リーダブルコードを発見→メモ
✓ issueにコメント
✓ 後で共有する時に使う
✓ 書くこと (例はissueに書いてある)
✓ コード・理由・見つけたきっかけ
メンターへ:メビューで使うのでメンターもメモろう
メンターへ:たまに「どんなメモ書いた?」と聞いて課題をこ
なすことではなくリーダブルコードを書くことに参加者の注意
を向けてみよう
コードチェンジ
Powered by Rabbit 2.1.7

Other slides

Apache Arrow
2017-06-13
Apache Arrow
2017-05-28
Mroonga!
2015-10-30