PublicComments

2008-12-29 21:40:47 +0900 (186d); rev 279

プロジェクトメンバー以外からの意見や質問を募集しています。

ページ移動のおしらせ

今後リファレンスのバグ報告は以下のページで行って下さい。

それ以外の要望や、質問に関しては引き続きこのページにコメントしてください。

2008-12-29: すいませんredmineへのticketの追加方法がわからなかったのでここに書きますが、問題があれば消してください。 http://doc.okkez.net/191/view/method/OpenSSL=SSL=SSLContext/i/verify_callback のctxは、SSLContextではなくてOpenSSL::X509::?StoreContextのはずです。 by なひ(連絡が必要であればnakahiro_at_gmail.comへお願いします)

注意

現在完成しているのは ruby-1.8 の組込みクラスについてのみです。 それ以外のライブラリに関しては細かな間違いは多々あるでしょうが、 随時直っていくと思われます。

PublicCommentsDone

意見を書く

意見・質問への回答

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