青木です。

  In mail "[ruby-reference-manual:80] メソッドで使う定数の場所"
  sheepman <sheepman@s...> wrote:

> こんにちは、sheepman です。
> メソッドで使う定数の説明は離れた場所じゃなくて、
> メソッドの近くにあった方が良いと思います。また、現在の
> リファレンスはそうなっています。

> しかし、これは定数を

> 以下に置くという方針と矛盾します。
> File.rd に関しては取り敢えず定数をメソッドとして整形してコミットしておきました。
> どのように扱うのが良いでしょうか。

原則として定数は単独のエントリを立て、そこへリンクすべきです。

ただし flock に対する LOCK_SH のように明らかにメソッドと
定数が関連している場合は、メソッド側に主な説明を書き、定数
エントリの説明は簡潔にしてメソッドにリンクを張っておくのが
よいと思います。

ちなみに、今回の形式ではエントリの順番は一切保存されません。
また、エントリ単独のページもありますから、「近くに置く」
のは無意味です。

--
青木峰郎

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