青木です。

  In mail "[ruby-reference-manual:81] Re: レベル 2 ブロック付きのドキュメント"
  sheepman <sheepman@s...> wrote:

> こんにちは、sheepman です。

> > クラスのドキュメントに移すか、全メソッドエントリにコピーするか、
> > どちらかで対応してください。Float の場合はクラスのドキュメントで
> > よいと思います。

> 説明文をコピーしてまわるのは DRY ではないので、何かコピーせずに済むような
> 機構が今後導入されることはありますか。

乗り気ではありません。日本語の文章は人間が読まないとテスト
できないので、書く労力よりもテストする (読む) 労力を減らす
ほうが重要です。できるだけ出力そのままの文章を置いておくのが
テストしやすい (読みやすい) ですから。

また、今回の場合は本当にコピーすべきなのか疑問でもあります。

これは明らかにコピーしたほうがよいと思えて、しかもそれは
#@include では解決できないというケースが 3 つ以上見付から
ない限り、粒度の小さいモジュール化機能は導入しません。

--
青木峰郎

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