当たり前のことなんだろうけど

PHPでOOPをやっていて思うこと。メソッドとかでオブジェクトが返されるときに返されるオブジェクトが何なのかというのがわかりづらい。PEAR方式のコメントがあるとかメソッド自体が短かければ、まぁ読めばわかるけど、複雑だったりするといちいちソースを読まなければいかんのはどうも効率が良くないんじゃないかなぁと。JAVAであれば必ず型指定するので、メソッドの定義を見るだけでいいんですけどね。
やっぱコメント書いておくしかないのかなぁ？