アカウント名:
パスワード:
まあ、単純に言って、ソースコード中に明示的に現れないようなメソッドがあるなら、ドキュメントに書いておくべきだよね。Agile方法論では「ドキュメントとしてのソースコード」という考え方を持っているけど、ソースコードがあればドキュメントは不要とは言ってない [capsctrl.que.jp]し。
ところで「既存のクラスに対していろんなところで拡張や変更を加えていて」っていうけど、Rails的には何のコードをどこに置くかはかなり決まっていて、おかげて探しやすくなっていると思うけど。既存のクラスに拡張や変更を行なったのなら、それもドキュメントに書いておけばいいんじゃない? 少なくとも拡張した張本人は、どこでどう拡張したか覚えているよね?
より多くのコメントがこの議論にあるかもしれませんが、JavaScriptが有効ではない環境を使用している場合、クラシックなコメントシステム(D1)に設定を変更する必要があります。
人生の大半の問題はスルー力で解決する -- スルー力研究専門家
玄人向け言語だと思う (スコア:3, 興味深い)
どこにも明示的に定義されていないメソッドや変数なんてものが山ほど出てくる。
(ぜんぶ動的に生成してる)
さらに、既存のクラスに対していろんなところで拡張や変更を加えていて、
実行時に、あるクラスの中身がどうなっているのか追うのが異常に困難。
「設定より規約」というけど、実際には「規約が全て」で、
規約(=仕様)を知らないとそれが即死亡を意味している。
たしかに馴れれば効率はいいかもしれんが、こんな黒魔術はどう見ても
絶賛されるようなもんじゃないと思ったよ。
あれがRuby文化なら、これ以上流行ったらとんでもない地獄が待っていそうだ。
それともRailsが異常なだけ?
Re:玄人向け言語だと思う (スコア:1)
まあ、単純に言って、ソースコード中に明示的に現れないようなメソッドがあるなら、ドキュメントに書いておくべきだよね。Agile方法論では「ドキュメントとしてのソースコード」という考え方を持っているけど、ソースコードがあればドキュメントは不要とは言ってない [capsctrl.que.jp]し。
ところで「既存のクラスに対していろんなところで拡張や変更を加えていて」っていうけど、Rails的には何のコードをどこに置くかはかなり決まっていて、おかげて探しやすくなっていると思うけど。既存のクラスに拡張や変更を行なったのなら、それもドキュメントに書いておけばいいんじゃない? 少なくとも拡張した張本人は、どこでどう拡張したか覚えているよね?