こんばんわ。やまね@るりま初心者です。

> 質問なんですが、引数を取るメソッドの場合、
> 必ず @param を使わなければならない(MUST)ということでしょうか?

これ、自分も気になりました。

> 例えば、1行で説明が終るようなメソッドの場合、引数の説明にも同じ内容を
> 書くということでしょうか

FalseClass やら TrueClass の作業をしたんですが
メソッドの説明で全部言い切ってるのに、とは思ったのですが
引数があれば @param な記述は必要なのかな、と思い
相当無理矢理に引数の説明を入れてます。

ドキュメントのソースを見ていただければ微妙さ加減が分かるとは思うのですが、
一方で青木さんが
「ドキュメントの質については (あまり) 考えなくて構いません。」
と言われていた、という事で次の作業フェイズにて
このあたりの検討が実施されるのかな、と思い
軽い気持ちで ci している次第です。(すみません


regards,

----
Yamane Toshiaki

yamanetoshi@g...

--
ML: ruby-reference-manual@m...
使い方: http://QuickML.com/