2008-07-03 18:11:57 +0900
(1d);
rev 223
プロジェクトメンバー以外からの意見や質問を募集しています。
ページ移動のおしらせ
今後リファレンスのバグ報告は以下のページで行って下さい。
それ以外の要望や、質問に関しては引き続きこのページにコメントしてください。
注意
現在完成しているのは ruby-1.8 の組込みクラスについてのみです。
それ以外のライブラリに関しては細かな間違いは多々あるでしょうが、
随時直っていくと思われます。
PublicCommentsDone
意見を書く
- 2008-05-31 04:48:46 +0900: koseki: ?DateTimeに時間をRationalで足す例が載っているとありがたいです。なかなか見つけられず苦労したので。 http://tinyurl.com/53avyz
- 2008-02-15 22:07:43 +0900: rock: 対象とする Ruby のバージョンをページに表示してほしいです。とくにオンライン版は，検索エンジンから来た人が現行 Ruby（1.8.6 のこと）のマニュアルと勘違いする可能性があります。
- 2008-02-15 12:29:38 +0900: rock: 1.8 版に問題を見つけたとき，最新版でそれが直っているのかどうかを確認する手段がありません。もし大変でなければ，適当な頻度で最新版がダウンロードできるようにしていただけるとありがたいのですが。
- 2008-01-15: rock: Matrix#column_size と Matrix#row_size がそれぞれ「列の大きさを返す。」「行の大きさを返す。」となっているのは，それぞれ「列数を返す。」「行数を返す。」の間違いだと思います。それにしても，このメソッド名は「列の長さ（つまり行数）」「行の長さ（つまり列数）」と誤解を招きそうです。
- sheepman: ありがとうございます。ここで意見を述べても ruby 本体に反映されることは100%ないです。ruby-dev あたりに代替案と一緒に投稿したら、割とすんなりエイリアスとして追加してくれるかもしれません。Matrix#column_dimension とかですかね。ちょっと長いな。
- 2008-01-15: rock: ruby-dev は恐れ多い（何か提案できるほど Ruby が分かってはいない）ので遠慮しておきますが，Ruby 自体についてここで書くべきではなかったので，今後はやめておきます。
意見・質問への回答
Q. デッドリンクの自動検出ができないか
念頭にありませんでしたが、特に難しくもないので ToDo に入れときます。
Q. メソッドの要約は付くのか
これは付けます。どう考えてもあったほうが便利なので。
クラスのドキュメントと同じように先頭の段落だけを抜き出す方法で実装するつもりです。
Q. Rubyに標準で添付・配布されているライブラリはなんと呼ぶのが適当？
「標準添付ライブラリ」と呼称しています。
ちなみに require しないで使えるライブラリは「組み込みライブラリ」です。
Q. クラスのページの冒頭に、ライブラリのページの冒頭にあるようなメソッド名一覧が欲しい
メソッド一覧を付けることはやぶさかではないのですが、
それが本当にやりたいことなのか、確信できません。
メソッド一覧が欲しいと思うのは、
クラスのページからメソッドの解説にたどりつくためでしょうか。
その場合、次のような解決策も考えられます。
まず、メソッド名が最初からわかっている場合、
ReFe 相当のインクリメンタルメソッド検索を
実装したほうが役に立つでしょう (これはそのうち実装予定)。
そうではなくて、クラスの解説を眺めつつメソッドを探している場合であれば、
?JavaDoc のようにメソッドの要約が見られる、短い一覧があったほうがよいでしょう。
で、以上のような可能性を考えたうえで、
なおメソッド名だけの一覧が欲しいかどうか、
考えてみてもらえませんか。
Q. このプロジェクトって誰がやってんの？
日本Rubyの会のメンバーを中心に 15 人くらいがやってます。
実動数だと 5 人くらい？
Q. なんで XHTML じゃないの？
なりゆき。
Q. HTML 以外に info が欲しい
検討します。
Q. 別にいまのリファレンスマニュアルでも困ってないんだけど
いまの形式だと書くほうが困るのです。
Q. 俺にもリファレンスマニュアルを書かせろ！
たくさん書くならプロジェクトに参加したほうが楽だと思います。
HowToJoin のページを見てください。
ちょっと書きたいだけなら、いずれ実装される予定のパッチ投稿機能を使ってください。
(参照：BitClustPatchManagementSystem)
Q. Rubyでプログラミングを始める人などに配慮して、由来が一見してわかりづらいメソッド名に由来（putsなら「put stringより」など）を書いていただけるとありがたいです。
無理です。例えば puts が本当に「put string」なのか調べる方法が分かりません。
Q. ウェブ上で1.8.6版はどこで見られるのでしょうか？
ウェブ上で1.8.6版は提供していません。
Q. 最新版のスナップショットは提供されていますか。
リリース前のものが次のページで提供されています。 http://www.ruby-lang.org/ja/man/archive/snapshot/
system revision 1.162