回答編集履歴
3
少し修正
test
CHANGED
|
@@ -4,9 +4,9 @@
|
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
|
|
7
|
-
|
|
7
|
+
どこまで書く書かないという判断はそのプロジェクトによって違うと思います。
|
|
8
8
|
|
|
9
|
-
結局最終的な目的にすべきなのは生産性で
|
|
9
|
+
結局最終的な目的にすべきなのは生産性ではないでしょうか。
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
|
2
更に修正
test
CHANGED
|
@@ -37,3 +37,15 @@
|
|
|
37
37
|
|
|
38
38
|
|
|
39
39
|
全てを鑑みてもコメントを書くコストが無駄ならば、やめるべきだと思います。
|
|
40
|
+
|
|
41
|
+
|
|
42
|
+
|
|
43
|
+
が、それでも政治的なものやルールを変えるためのハードルやコストなどもありますので
|
|
44
|
+
|
|
45
|
+
トータルで考えると、プロジェクト途中でルールを変えるのはあまり得策だとは思いません。
|
|
46
|
+
|
|
47
|
+
（小さいプロジェクトならできるかもしれませんが。）
|
|
48
|
+
|
|
49
|
+
|
|
50
|
+
|
|
51
|
+
新しくプロジェクトが立ち上がる時に考えるべきことなのかなとは思います。
|
1
修正
test
CHANGED
|
@@ -6,7 +6,7 @@
|
|
|
6
6
|
|
|
7
7
|
ただ、どこまで書く書かないという判断はそのプロジェクトによって違うと思います。
|
|
8
8
|
|
|
9
|
-
結局最終的な目的にすべきなのは生産性
|
|
9
|
+
結局最終的な目的にすべきなのは生産性です。
|
|
10
10
|
|
|
11
11
|
|
|
12
12
|
|
|
@@ -22,9 +22,11 @@
|
|
|
22
22
|
|
|
23
23
|
|
|
24
24
|
|
|
25
|
-
プロジェクトが大きければ大きいほど、長ければ長いほど、コメントは重要になって来ると思います。
|
|
25
|
+
基本的にはプロジェクトが大きければ大きいほど、長ければ長いほど、コメントは重要になって来ると思います。
|
|
26
26
|
|
|
27
|
+
（コーディング規約やコメントルールを守るためのコストもかかって来ますが・・・）
|
|
28
|
+
|
|
27
|
-
小さく短いなら恐らく書くのは無駄です。
|
|
29
|
+
小さくて短いプロジェクトなら恐らく書くのは無駄です。
|
|
28
30
|
|
|
29
31
|
|
|
30
32
|
|
|
@@ -34,4 +36,4 @@
|
|
|
34
36
|
|
|
35
37
|
|
|
36
38
|
|
|
37
|
-
全てを鑑みても
|
|
39
|
+
全てを鑑みてもコメントを書くコストが無駄ならば、やめるべきだと思います。
|