Text
Page: 1
課題の実装の進め方
結城洋志
株式会社クリアコード
実践リーダブルコード
2019-09-24
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 2
実装する目的
午後の作業の布石
↓
✓ 課題の仕様を理解するため
✓ 読まれることを意識して
書かれたコードを用意するため
✓ リーダブルなコードを書いて！
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 3
目的じゃないこと
✓ テクニックをたくさん覚える
✓ 難しいプログラムでも
実装できるようになる
✓ 速く実装できるようになる
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 4
課題の傾向
✓ 技術的に難しいことは
意図的に避けている
✓ 段階的に改良していく
✓ 時間内で実装しきれない分量
✓ すべて実装する必要はない！
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 5
メモを書く
✓ 工夫したことはissueに書く
✓ 1つのissueに1つの工夫でOK
✓ メモに含めること
✓ 実際のコードのURL
✓ リーダブルな理由
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 6
メモ例
タイトル： 統一されたスタイル ← リーダブルな書き方の名前
↓本文↓
--
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);
理由:
ファイル内でスタイルを統一しているので読みやすくなっている。
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 7
リーダブルコードとは
✓ 読む人基準
✓ 「読む人」が
リーダブル
読みやすいなら
✓ 読む人の視点を意識してみて
✓ どんな人が読む？
✓ どんな前提知識がある？
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 8
困ったら1
✓ チューターに相談
✓ チューターは答えを教えない
✓ 一緒に考えてくれる
✓ 答えを教えない理由
✓ 参加者が考える機会を奪わないため
✓ 一緒に考えると新しい視点が増える
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 9
困ったら2
✓ まわりの参加者に相談
✓ 答えを教えてもよい
✓ 一緒に考えてもよい
✓ 条件
✓ 答えを教えるときは理由も伝える
（教える参加者が考える機会になる！）
✓ 聞く人は理由も聞く
（考え方を知ると新しい視点でコードを読める！）
課題の実装の進め方
Powered by Rabbit 2.2.1
Page: 10
実装開始
✓ 仕様
✓ task.md
✓ 練習
✓ 講師がtask.mdを読んで説明
✓ 仕様1をみんなで実装
✓ 実装できたら休憩→仕様2以降実装
課題の実装の進め方
Powered by Rabbit 2.2.1
