勉強会 - 4

1. 勉強会 - 4
山﨑 健士

2. まず
リーダブルコード
―より良いコードを書くためのシンプルで実践的なテクニック
(Theory in practice)

3. 読んだ気になろう
そして自分で繰り返し読もう

4. 第１部 表面上の改善

5. 5章 コメントすべきことを知る

6. 5.2 自分の考えを記録する
「監督のコメンタリー」を入れる
ヒューリステック 【英】 heuristic
• 必ず正しい答えを導けるわけではないが、ある程度のレベル
で正解に近い解を得ることができる

7. 5.2 自分の考えを記録する
コードの欠陥にコメントをつける
アノテーションコメント
[アノテーション]: [コメント本文]
TODO 未実装なタスク
FIXME 不具合
HACK リファクタリング候補
XXX 正しくないが多くの場合動いてしまう
OPTIMIZE パフォーマンスに影響を与える最適化すべき
REVIEW レビューすべき

8. ６章 コメントは正確で簡潔に

9. ６.７ 「名前付き引数」コメント
C#
Foo(arg1: 1, arg2: ”bar”);
Scala
foo(arg1=1, arg2="bar”)
Swift
foo(arg1: 1, arg2: "bar”)
Python (キーワード引数という)
foo(arg1=1, arg2="bar"):

10. 6.8 情報密度の高い言葉を使う
ブルートフォース
• 総当たり攻撃
ナイーブソリューション
• 初心者なりのひねりのない正直すぎるコードや解決法