スルーしてたんですが、何するんだろ。comment?_19(Thu)http://d.hatena.ne.jp/seiunsky/20060118/1137606585MSDNやSunが書いているjavadocなどと比較するのはなぁ、と一瞬思ったけど、利用者は比較して当然なのかも(というか、比較しない理由は無い)。全部ボランティアベースだとか、そんなのは(利用者的には)まったく関係ないんだから。いう比較をすると、「Rubyのドキュメントダメダメ」と思うのは当然なのかも。perlはよく知らないんですが、そんなにドキュメント充実しているんですか。自分は基本部分のドキュメントが不足しているとは思ってないんだけど。なんか、イメージ戦略か何かが必要なのかも。逆に「ボランティアなのにこんなに充実していて凄い!」みたいなことを思わせる何か。ちなみに、不足をマイナスにしたり、割り算の優先順位とかどうなんだろう、とどうでもいいことを思ってみる。magazine休刊を見て)。これも、どうあるべきなんですかねぇ。まも、どうしたもんなんだか。字を小さくするのは冗談として、見映えはあんまり良くないですね。2006)どうも初めまして。リンクありがとうございますー。急ぎ足で書いた文章なので言葉足らずなところもあったのですが、カンタンに言ってしまえば「かんたん・わかりやすい」と言ったキャッチコピーと情報を集める時のギャップがあるなぁ、と。あと、Perlの公式のドキュメントって知らないですけど(ぇ)、歴史がある分Webで調べるのは結構できますよね。まー、そんなとこの愚痴でした。MSDNに関しては操作性はロクでもないですけど(Firefoxだと文字化けするし!)、VSのF1キー(ヘルプ)と連動してますからねぇ。あの変なブラウザに我慢すれば大体なんとかなるような気がします。......っと、ちょっと長くなってしまってすいません。2006)わわ、改行が......。2006)MSDNが特別最悪だとは思わないんですけど、俺の感覚が変なのかな。今のリファレンスマニュアルのデザインもかっこ悪いと思っていない俺は、やっぱり感覚が変なのかもしれない(というわけで、カッコイイRubyは無理ぽ)。「Rubyは簡単」というのは、「情報もそろってて簡単、ばっちり」ということを連想させるから、現在のドキュメントを探し出すとっつきにくさのギャップが逆に目立つ、ということなんでしょうか。なると、そもそもRubyは使いづらいと吹聴しておけばそもそも問題ないのか(違)。いや、そうしておいたほうが、隠し技になってくれてうれしいのかも。Rubyの普及を推進したい人たちの団体はできないものかな。日本Rubyの会はそういうものではないし。それとも、日本Rubyの会の中にも、普及を目的とした何かを作る必要があるのかも。Perlの情報ってどうやって調べるんでしょうか。比較してどうなんだろ。日本語でまとまった情報はどうやって調べるんだろう。私がPerlが苦手な理由はドキュメントの調べ方がわからなかったことなんだけど。Pythonは充実してると思う。関数ばかりなのがどうにも苦手。問題の一つではないかと思っています。ページにはそのサイトへのリンクだけがあるようなケースです。2006)うーん、refeはどれくらい使われているんだろう。2006)このエントリを読んで考えて,いつぞやの「RAAじゃダメなんですか」という質問への答が出たので,まとめてみました。Module)のドキュメントについての話です。兼ねて,「Perl/CPANユーザから見たRAAがイマイチに思える点の指摘」ということで聞き流してください。大雑把に言うと,二つの点でモジュールのドキュメントを探しにくい・読みにくいと感じました。上で指摘のある通り,モジュールのドキュメントが集まっていないこと。PerlはCPANに集まっている→それを前提としたツールができて使いやすくなる→魅力的なツールがあるからCPANにアップロードしたくなるという好循環が出来ているのだと思います。Rubyはこれが逆に回っているのでは?この辺の話を一つ目のエントリに書いてみました。タイトルは煽ってますけど。CPANにはツールが色々あるんですよ,という話です。Perl/CPANの良いところ〜なぜCPANにはモジュールが集まるのか二つ目はモジュールのドキュメントの文書構造です。各モジュールのドキュメントの質・量は作者さん次第というところも多いので単純に比較するものでも無いと思うのですが,今回RAAからいくつかのモジュールのドキュメントを見て,どうもPerlのモジュールの方が読みやすいように思いました。manを踏襲した文書構造で書かれていて(確かどこかでこれを推奨していたはずです),欲しい情報を最初に提示してくれているのに対し,Rubyのモジュールは順序がモジュールごとにばらばらで,欲しい情報がなかなか出てこないと思いました。この辺を二つ目のエントリに書いてみました。概略を言うと,Perlのモジュールのドキュメントは「このモジュールではこんなことができるよ」というのを何よりも先に提示しているのです。文章ではなく,SYNOPSISというコードで。SYNOPSISはその後に続くリファレンスをどこから読み始めれば良いかという情報も提供しています。して,モジュールのユーザの興味を最初から惹きつける(あるいは「あ,違う」とさくっとあきらめさせる)文書構造になっています。このエントリの最後で「この順番が逆だったら?」と書いていますが,これは実はruby-dbiのドキュメントがほぼその順で非常に読みにくいと感じたからです。他にも似たようなパターンがあったように思います。「このモジュールで何ができるの?」と思ってドキュメントを見たユーザが最初に目にするのがライセンスで,次に何人もの(ユーザにとっては初めて目にする・あるいは興味が無かったりする)名前が続き,その後も色々とあったあげく,最後の最後でExampleが出てくる,しかも実際のドキュメントは別のページだよ,と出てくる訳です。LISENCEという「共通の文書構造」で読めるので,100個のモジュールの中から自分の欲しいモジュールを探すのも容易であるのに対し,Rubyではあちこちページをたどってどうにかドキュメントを見つけ・・・10個くらいで飽きてきます。この2点がいつぞやの「RAAじゃダメ」の答えです。ちなみに「Perlの情報の調べ方」も書こうとしていたのですけど,いつの間にか「CPANモジュールネタの仕入れ方」になっていたので割愛させていただきます。Perlともども今後とも発展していくことを祈って。ここでこの手の話題なので。comment?_18(Wed)某fate、OPダメダメ。closureって、環境をcloseするもの、でいいと思うんだけど、足りないのかしらん。Ruby」という書籍はどうだろうなぁ、と思う今日この頃。2006)「Effective」よりも、"たのしい","おいしい"(レシピブック)に続くシリーズ(?)として、"かっこいいRuby"がいいね、という話を以前babieさんとしてました。「カコイイRuby」って呼ぶから。T4って,バッテリーが素敵に持つ(ecoモードで8時間)ので,素敵に長居ができる(迷惑な客).というか、家に機材そろえてるんだから、そこでやれよって感じだ。2006)HPCって奥が深い、というかキリが無いですね。2006)結構なんとかなるもんですよ。いうか、後でまとめて調べればそれなりにはかどります。Mobileが入ってるから誘惑がなぁ......契約しなければいいだけの話だけど。orzごめんなさいごめんなさいごめんなさい。最悪、バスかな...。2006)アスパラに並木研のレポート載ってますよ。並木研が紹介されていますね。2006)仕様がよくわからないけど。これからはPythonの時代デスネ。なんてシステムコールがほしい...。読み返してるんだけど、わかりやすいですね、問題点が。持つようなセマンティックスになってくれれば、いいんだけど。失敗する、シグナルを受けるとhandleはシグナル状態になる、みたいな。シグナル状態の解除は明示的になんかする。指すオブジェクト、か。問題にしているのはもっと一般的な話だけど)。いいような気がしている人。関しては、まだ理解できていない。運が悪いと(シグナルが入っても)ずーっとブロックするよ、みたいな...。うーん、これで古畑任三郎終わりか。ブロックしてるやつを再開させるには、どうしたもんかな。