京都は近かった。 こないだ 24 時間近く飛行機でかかったのと比べると、 2 時間半なんてあっというまでした。 ちょっと寝てたら着いちゃったもんな。
勉強会の規模が毎回大きくなってるてのは聞いてたけど、 いまはずいぶんでかくなってるんですね。 今回は 60 人くらいだったっけ。 にぎわっているのはいいことだ。
自分のセッションの内容はこのあと書くので略。
自分の以外のセッションは、まず、 かずひこさん & 京都女子大生s による TDD 講座、 znz さんによる "about Nadoka"、 あとは小波ゼミ生による発表、という内容でした。
一番おもしろかったのは TDD 講座かな。 ペアプロやったのなんて初めてだ。 けっこう難しいもんですね。
勉強会のあとは、定例の場所らしい飲み屋で一次会 (20:00 ごろまで)。 駅までのバスが女子高生で埋め尽くされており、 その対応によってそれぞれの本性が垣間見えた。 飲み会では、リファレンスマニュアルの話もしたが、 その他になぜか哲学で話が弾んだりした。
続いて根性のある人達による二次会 (23:00 ごろまで)。 まだ飲み続ける。
さらに、もう帰れない人達と、いつでも帰れる人達による、 夜を徹した三次会 (03:00 ごろまで)。 なぜかまたしても哲学で話が弾む。 そういえば cuzic さんは家に帰れたのだろうか。
最後は、もう帰れない人達 (Youhei さん、にしはたさん、青木) が漫画喫茶で夜明け待ち。 ドラゴンボールをギニュー特戦隊からブウ編まで読んだ (その暇に寝ろって話もある)。
そのあとは一人で京都観光しようかと思ってたんですが、 さすがに力尽きたので清水寺だけ参拝して帰宅。 朝の 8 時だというのに観光客はいるし、 ちゃんと八つ橋屋も開いてるし、さすが京都だと思った。 買わなかったけどな。
(21:09)
自己紹介は略
[Ruby リファレンスマニュアルとは]
[Ruby リファレンスマニュアル刷新計画とは]
[リファレンスマニュアル 10 の不満]
「Ruby言語仕様」とか。 もっとも、これは青木が書きかけで放置したのが最大の原因である。
あとは、標準添付ライブラリのリファレンスが足りない。
C API リファレンスは見ることすらできなくなっている。
語尾が揃ってないとか、重複するドキュメントが多いとか。 例えば「FAQ」と「Rubyの落とし穴」は意味的に重複する。
$stdin のエントリの例を引いて説明。 いろいろなことを同時に説明しようとしているせいでわかりにくい。
自分が知りたいのは特定バージョンの Ruby の仕様だけなのに、 1.6 から 1.9 まで全部ごちゃまぜに書いてある。
気に食わない。
いまはただのテキスト検索でしかない。 ReFe レベルの検索ができるようにしたい。
上記の不満に比べれば些細なことではあるが、 できれば対処したい。
一つのメソッドシグネチャの記述だけで 5 種類あったりとか。 標準添付ライブラリはファイル構成も明確な規準がない。
記述形式がバラバラ → ちゃんとメタデータが取れない → クラスツリーなどが自動生成できない
sed で全部処理だー、とか思っても、できない。 300 近いファイルを全部手でいじらなければならない。
[解決策]
以下詳述
[解決策1： 新システム BitClust]
※ 最後の点については、制限というよりは仕様であるという認識。 この点を補うアイデアとして、Wiki のようにウェブ上から編集すると、 その diff がメンテナに送られるというサブシステムを提案する。 メンテナはその diff を読んだうえで、取り込むかどうか決める。
[解決策2： コンテンツの再編成]
[解決策3： 文章の質の改善]
[目標]
[現状]
ドキュメントの変換は、伊達さん、sheepman さん、岩月さんが がんばってくれたおかげでめちゃめちゃ進んでます。 残ってるのはほぼわたしが止めているという体たらく。
[課題]
[人材募集]
[参加方法]
To: ruby-reference-manual ＠ ml.fdiary.net Cc: aamine ＠ loveruby.net
(21:37)
無粋ですが、フォロは英語で言うforum、つまり公共広場ではないかと。
RPGみたいな旅行記ですね(^_^)