回答編集履歴
3
修正
test
CHANGED
@@ -63,3 +63,13 @@
|
|
63
63
|
コメントが全くないコードは数日、数週間経ったら自分ですら何のために書いたコードか分からなくなりますから。
|
64
64
|
|
65
65
|
[三日前に自分が書いたコードは、他人が書いたコードと同様に理解不能](https://qiita.com/rana_kualu/items/95f0c8be51e8665015d5#%E9%96%8B%E7%99%BA%E3%81%AB%E9%96%A2%E3%81%97%E3%81%A6)ですよ。
|
66
|
+
|
67
|
+
|
68
|
+
|
69
|
+
他にもこういう記事もあります。
|
70
|
+
|
71
|
+
- [初心者を戒めるPHP](https://qiita.com/tadsan/items/fb496e450fc27c8c4494)
|
72
|
+
|
73
|
+
> PHPDocは必ず書け
|
74
|
+
|
75
|
+
あらゆる再利用可能な手続きは、他人が容易に応用できるように型が明示的でなければいけない。メンバー全員が実装コード全てを把握できるものならそれが理想だけれど、残念ながら時間は有限だ。ヘッダだけを読んでメソッドの仕様が理解でき、またはコードを読む助けになるようなコメントが良い。
|
2
追記
test
CHANGED
@@ -51,3 +51,15 @@
|
|
51
51
|
}
|
52
52
|
|
53
53
|
```
|
54
|
+
|
55
|
+
|
56
|
+
|
57
|
+
> そのほかにも恩恵はありますか?
|
58
|
+
|
59
|
+
|
60
|
+
|
61
|
+
関数の仕様が分かるということ以上に欲しい恩恵はありませんね。
|
62
|
+
|
63
|
+
コメントが全くないコードは数日、数週間経ったら自分ですら何のために書いたコードか分からなくなりますから。
|
64
|
+
|
65
|
+
[三日前に自分が書いたコードは、他人が書いたコードと同様に理解不能](https://qiita.com/rana_kualu/items/95f0c8be51e8665015d5#%E9%96%8B%E7%99%BA%E3%81%AB%E9%96%A2%E3%81%97%E3%81%A6)ですよ。
|
1
修正
test
CHANGED
@@ -6,7 +6,7 @@
|
|
6
6
|
|
7
7
|
|
8
8
|
|
9
|
-
EclipseなどIDEでは関数の前に
|
9
|
+
EclipseなどIDEでは関数の前に`/**`と打ってEnter押すだけで雛形を呼び出してくれますね。
|
10
10
|
|
11
11
|
```php
|
12
12
|
|