練習の仕方¶ ↑
: author
須藤功平
: institution
株式会社クリアコード
: content-source
SEゼミ2015 - リーダブルコード勉強会
: date
2015-06-06
: allotted-time
5m
: theme
clear-code
課題が目指すこと¶ ↑
((‘tag:center’)) ((‘tag:large’)) ((‘tag:margin-bottom’)) ↓を体験する
* コードを読んで * リーダブルコードを((*見つける*)) * ↑を活かしてコードを書く
課題が目指さないこと¶ ↑
* テクニックをたくさん((*覚える*)) * 難しいプログラムでも\n 実装できるようになる * 速く実装できるようになる
課題の傾向¶ ↑
* 技術的に難しいことは\n 意図的に避けている * 段階的に改良していく * 時間内で実装しきれない分量 * ((*すべて実装する必要はない!*))
練習としてやること¶ ↑
((‘tag:center’)) ((‘tag:x-large’)) 仕様1を実装n ((‘note:進め方の詳細はtask.mdを参照’))n ((‘note:github.com/clear-code/sezemi-2015/から辿れる’))
((‘tag:margin-top’)) ((‘tag:margin-top’)) ((‘note:メンター:参加者がtask.mdを見つけられるようにサポート’))n ((‘note:メンター:見つけられたら教えて’))
メモ¶ ↑
* 課題は精一杯の\n リーダブルコードで実装する * リーダブルポイントをメモする * メモはリポジトリーにpush * 書き方は後述 * コードを交換した相手も読むよ!
リーダブルコードとは¶ ↑
* 読む人基準 * 読む人が\n 読みやすいなら\n リーダブル * 読む人の視点を意識してみて * どんな人が読む? * どんな前提知識がある?
困ったら1¶ ↑
* メンターに相談 * メンターは((*答えを教えない*)) * 一緒に考えてくれる * なんで!?答えを教えてよ! * トレーナーが禁止している\n (('note:(参加者が考える機会を奪わないため)')) * メンターは意地悪ではない
((‘note:メンターへ:新しい視点に導いてあげてください’))
困ったら2¶ ↑
* まわりの参加者に相談 * 答えを教えてもよい * 一緒に考えてもよい * ヒント * 答えを教えるときは理由も伝える\n (('note:(教える参加者が考える機会になる!)')) * 聞く人は理由も聞く\n (('note:(考え方を知ると新しい視点でコードを読める!)'))
困ったら3¶ ↑
* 他の参加者のコードを見る * コードから学ぶ! * この勉強会で大事にしていること * ヒント * 参考にするときは理由を考える * どうしてこのコードがリーダブル? * メモに書こう
課題1が終わったら¶ ↑
* メンターに確認依頼 * →OKなら各自休憩 * 休憩後 * task.mdを最初から読み直す * 読み直したら課題2以降を進める * 随時メモを書こう!
((‘note:メモ:task.mdにあるメモの書き方例を紹介することを忘れない’))
…課題実装中…¶ ↑
* 今の自分の精一杯の\n リーダブルコードを書こう * ↑をmemo.mdにメモろう * 実際のコード・説明・一言説明 * 例はtask.md参照
((‘note:メンターへ:メビューで使うのでメンターもメモろう’))
((‘note:メンターへ:たまに「どんなメモ書いた?」と聞いて課題をこなすことではなくリーダブルコードを書くことに参加者の注意を向けてみよう’))