回答編集履歴
2
軽微な誤字修正
answer
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
## その他のコメント
|
|
15
15
|
- why を書く
|
|
16
16
|
- What や How がないと理解できないルーチンは抽象度が足りない
|
|
17
|
-
- そのような抽象度が足りない処理
|
|
17
|
+
- そのような抽象度が足りない処理はサブルーチンに切り出して適切な名前とDocコメントをつける。コメントに頼らない。
|
|
18
18
|
|
|
19
19
|
## 結果として
|
|
20
20
|
- Docコメント以外ではWhy以外を書く必要がなくなる
|
1
言葉が足りない部分があったので追加
answer
CHANGED
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
## その他のコメント
|
|
15
15
|
- why を書く
|
|
16
16
|
- What や How がないと理解できないルーチンは抽象度が足りない
|
|
17
|
-
- サブルーチンに切り出して適切な名前とDocコメントをつける
|
|
17
|
+
- そのような抽象度が足りない処理にはサブルーチンに切り出して適切な名前とDocコメントをつける。コメントに頼らない。
|
|
18
18
|
|
|
19
19
|
## 結果として
|
|
20
20
|
- Docコメント以外ではWhy以外を書く必要がなくなる
|