なぜ Ruby のドキュメントは貧弱なままなのか背景を教えてください。標準添付のライブラリの API を調べたいと思っても、http://www.ruby-lang.org/ja/ からは見つけるこ..

littlebangkok あなたも質問に答えられます！ウォッチリストに追加
状態：終了
回答数：5 / 10件
回答ポイント：120ポイント
登録：2008-12-03 19:12:26
終了：2008-12-08 21:07:21
カテゴリー：コンピュータインターネット

5 回答者：onering 2008-12-07 11:27:16 満足！ 30ポイント

既に人的リソースが足りないから、という理由が提示されていますので補足を。

英語の方が充実しているのは英語の方が圧倒的に利用者が多いからです。またRubyやRailsに対する注目が急に高まって追いつかないからです。例えばRailsはRubyユーザの多数を占めていると思いますがアメリカのRailsConf 2007は1200人でRuby会議の数倍規模です。日本ではまだRails単独でカンファレンスが開かれていませんが、それだけのユーザ規模がないからです（と言っても数百人規模でいると想像しますが）

■「RailsConf 2007の定員は1,200人」

http://d.hatena.ne.jp/ogijun/20070206/p2

■「スピーカーやスタッフも含めたRubyKaigiの開催規模は年々拡大しています。2006年は約200名，2007年は約400名，2008年は約600名でした」

http://gihyo.jp/news/report/01/rubykaigi2008/0003?page=3

質問者：

littlebangkok 2008-12-07 22:01:12

> 英語の方が充実しているのは英語の方が圧倒的に利用者が多いからです。

> またRubyやRailsに対する注目が急に高まって追いつかないからです。

この回答をいただいて、別の疑問が浮かびました。なぜ英語圏のユーザーの方が、日本のユーザーよりも多い背景は何だろうと。

1. 日本のユーザーはメインストリームの言語を利用するだけで、他の言語への関心を持ちにくい

2. 英語圏のユーザーが多いのは、Perl 以外の使いやすい言語を求める下地があった

3. 日本では Ruby で作成した成果物の需要がない(仕事にならない、利用ユーザーが少ないなど)

4. 単純に母集団の大きさが異なるから(「日本語のみで理解でいる Ruby ユーザー数」と「英語を理解できるユーザー数」)

などなど。

カンファレンスに出席をしたいと思うのですが、平日開催のカンファレンスが多いように感じ、出席する都合がなかなかつけられないという個人的な事情があります。

土日開催歓迎!!

1 回答者：standard_one 2008-12-03 19:34:22 満足！ 20ポイント

作者の意識レベルをそのまま反映しているからでしょう。

きっとこの人、空中分解したプロジェクトの後始末をやらされたことがない、幸せなプログラマなんでしょうね。

http://slashdot.jp/developers/article.pl?sid=03/03/14/0258247

質問者：

littlebangkok 2008-12-03 20:07:13

ということは、彼個人の人間性に起因するものであって、別に Ruby コミュニティと表に出てこない確執が要因ではないと考えられるということですね。

ちなみに Ruby は便利に使わせてもらっています。

2 回答者：hijk05 2008-12-03 20:01:57 満足！ 20ポイント

Rubyが日本に普及したのは、「Ruby on Rails」が登場してからのことで、ここ数年前のことだと思います。だから、人的リソースがないからというのもあると思います。「Ruby on Rails」は外国人によって作成されたこと、Rubyの最終的な言語仕様は作者に聞くしかないことがドキュメントを貧弱にさせています。

最近では、Ruby1.9系とRuby1.8系では、互換性がないこと、Ruby1.9の移行に失敗したことにょって、余計に人的なリソースが少なくなります。

あと、Rubyでお金儲けをしようとする日本企業が多いので、情報やテクニックがフィードバックされないとかもありえます。

http://q.hatena.ne.jp/answer

質問者：

littlebangkok 2008-12-03 20:16:57

> だから、人的リソースがないからというのもあると思います。

> Ruby1.9系とRuby1.8系では、互換性がないこと、Ruby1.9の移行に失敗した

この辺の影響は大きいかもしれませんね。

私も RoR の登場がなければ、名前だけを知っている開発言語という位置のままだったかもしれません。

3 回答者：rubikitch 2008-12-03 21:13:35 満足！ 30ポイント

その理由のひとつは、旧来のリファレンスマニュアルはメンテナンス困難になっているからです。この問題に対処するためにRubyリファレンスマニュアル刷新計画（通称「るりま」）というプロジェクトが活動しています。どうぞ。

http://doc.loveruby.net/refm/api/

それでも人的資源が不足しているので、早急に結果を求めるのは酷でしょう。

> 日本人の手によって開発されたプログラミング言語なのに、なぜ他言語 (英語) のほうが充実しているのか理解に苦しみます。

Rubyは世界で使われている言語だから不思議なことではありません。現に外国人の開発者も存在します。もはやRubyは「日本人だけの手によって」開発された言語ではありません。

RubyのドキュメントはRDocというソース内埋め込みドキュメントで作成されています。RDocは英語で書かれています。ソース埋め込みということは、ソースコード更新とともにRDocも更新されることを意味しています。そのため、RDocが最新かつ手軽に更新できるドキュメントとなっています。

日本語ドキュメントはRDocとは別個に更新しないといけない上、RDocの書き手≠日本語ドキュメントの書き手なので、日本語のドキュメントの更新が遅くなるのは仕方がありません。

質問者：

littlebangkok 2008-12-04 01:05:45

Ruby を使い始めて１年半ほど経過していますが、「http://doc.loveruby.net/refm/api/」の存在を初めて知りました。

> もはやRubyは「日本人だけの手によって」開発された言語ではありません。

これは、id:standard_oneさんがリンクを記述してくれた

>> http://slashdot.jp/developers/article.pl?sid=03/03/14/0258247

>> もはやRubyのもっとも活発なコミュニティは英語によるメーリングリストruby-talkであり

にあることを知りましたし、最近 Ruby の ML で言語間の壁が存在し、ML の自動翻訳の話題を憶えています。ですので、日本人だけで開発されているとは思っていません。(書き方が誤解を招いたようです)

> 日本語ドキュメントはRDocとは別個に更新しないといけない上、RDocの書き手≠日本語ドキュメントの書き手なので、

> 日本語のドキュメントの更新が遅くなる

更新に時間がかかるというのは理解できます。英語でもいいので、日本語の公式サイトにせめて RDoc を置くことはできるとは思うんです。

自分に限っていえば、日本語のドキュメントではなく、メソッドの概要、必要な引数、返り値の内容などがわかれば、後は試行錯誤できると思います。

とはいえ、ドキュメントを充実させようと活動されているのがわかっただけでも、良かったです。

4 回答者：taka-hr 2008-12-04 15:55:20 満足！ 20ポイント

http://www.ruby-lang.org/ja/ から、右のカラムの

「ドキュメント」に行って、真ん中あたりの

マニュアルのところの「リファレンスマニュアル」に行けば、

http://www.ruby-lang.org/ja/man/html/Ruby_A5EAA5D5A5A1A5ECA5F3A5...

に到達できます。

さらに下のほうには「新バージョンのリファレンス」として、

すでに紹介のあった http://doc.loveruby.net/refm/api/ にも

行けます。

参考までに。

質問者：

littlebangkok 2008-12-04 19:36:13

http://www.ruby-lang.org/ja/man/html/Ruby_A5EAA5D5A5A1A5ECA5F3A5...

の存在は知っていました。普通にググルと出てきますよね。

私としてはもっと詳しい API のリファレンスです。欲を言えば、サンプルコードが掲載されていると助かります。

今は、API のリファレンスが掲載されている

http://www.ruby-doc.org/stdlib/

を活用しています。

頑張って

http://perldoc.perl.org/index-functions.html

や

http://www.php.net/manual/ja/

まで充実するとすばらしいと思います。

おとなり質問

この質問・回答へのコメント

rubikitch 2008-12-04 02:47:47

メソッドの概要、必要な引数、返り値の内容などがわかれば、後は試行錯誤できると思います。

ということなのでReFe2の使い方は↓を見てください。
http://d.hatena.ne.jp/rubikitch/20080102/rubyrefm
http://d.hatena.ne.jp/rubikitch/20071228/rubyrefm

英語ならばRubyと同時にインストールされたriコマンドでも調べられます。

littlebangkok 2008-12-04 19:37:17

調べて試してみます。
貴重な情報ありがとうございます。

toby 2008-12-05 20:12:20

この手の質問はコミニティ内で繰り返されているようですが「ソース読め」と言われることが多いですね。

私は、別所で配布されている.chmとriとソースを読むことで乗り切っていますが、
(最近弄っている)phpのオンラインドキュメントの親切さを知ると、
Rubyの状況は異常なことに気づいてきました。
さすがにユーザー数のケタが違うphpと比べるのはアレですが、
やっぱりこの辺が普及の妨げになっているとするとよくないことですね。

littlebangkok 2008-12-07 15:42:41

> (最近弄っている)phpのオンラインドキュメントの親切さを知ると、
> Rubyの状況は異常なことに気づいてきました。
おそらく Ruby は習得するよりも、調べる時間の方が負担になるように思います。
そこで挫折してしまうのはもったいないと、利用者にもコミュニティにももったいないと思うんです。
だって、人数が多くなればなるほど、フィードバックも増えると思うんです。フィードバックが増えれば、それだけ改善のチャンスが増えるて、ユーザーが受ける恩恵に繋がると思うんです。

> やっぱりこの辺が普及の妨げになっているとするとよくないことですね。
本当にもったいないことです。

onering 2008-12-07 16:44:25

言語指定のRubyというだけでなくRailsとの関係で捉えると理解しやすいと思います。
海外でRailsというRubyのキラーアプリが産まれて、みんなRailsを使うためにRubyを使い始めている。。。ので純粋に言語としてのRubyに惹かれた人よりもRailsから参入した人が多いと思います。逆輸入のブームなのでRubyの日本語マニュアルチームへの人材流入に直結しない、という側面はあるかと。

littlebangkok 2008-12-08 21:04:00

> 逆輸入のブームなのでRubyの日本語マニュアルチームへの人材流入に直結しない、
> という側面はあるかと。
それに RoR を利用できる環境も限られますので、ユーザーも限定されるのでしょうね。
そういう意味では、Ruby を利用できる環境(ホスティングサーバーなど)が増えてほしいです。

この質問・回答へのトラックバック

www.textfile.org - なぜ Ruby のドキュメントは貧弱なままなのか背景を教えてください。 2008-12-07 08:22:54

なぜ Ruby のドキュメントは貧弱なままなのか背景を教えてください。 - http://q.hatena.ne.jp/1228299144 はてなの質問。

OneRingToFind by 榊祐介 - はてなに「なぜRubyのドキュメントは貧弱なままなのか教えてください」という質問が 2008-12-07 11:36:33

はてなに「なぜRubyのドキュメントは貧弱なままなのか教えてください」という質問がなんだか批判的な意見が多くて萎える。一般ユーザからはそういう見方なのかなあorz。良い言語設計

トントカイモ - 戸締まりには気をつけましょう 2008-12-09 01:14:57

戸締まりには気をつけましょう修論について。初めはシミュレーションで「ほら、コミュニティ規模が十分に拡大すると、ネットワーク全体が連結するでしょう！」と言うことを示すつ

煩悩是道場 - 『日本語の危機とウエブ進化』読了 2008-12-15 05:56:41

『日本語の危機とウエブ進化』読了新潮2009年1月号に掲載されている水村美苗氏と梅田望夫氏の特別対談『日本語の危機とウエブ進化』を読んだ。『日本語が亡びるとき―英語の世紀の中

ありがとう/貧弱なサーバー/「貧弱なサーバー」：最新情報ありがとう 2009-02-20 09:59:44

「39サーチ」では、あなたが入力したキーワード「貧弱なサーバー」に関する最新の感謝情報をインターネットから徹底検索しています。「貧弱なサーバー」：最新情報「貧弱なサー