[ruby-list:35937] WeRDS (the Weekly Ruby-Doc Summary) 2002-09-13

すぎむし。

Rubyのドキュメントを標準化しよう、というプロジェクトが
ruby-talkで勃興しました。ruby-docメイリングリスト、と
いう形を取って活動しはじめた(企画を練っている)ところで、
すぎむしも参加して様子をうかがっています。

以下がJames Britt氏のまとめた今週(まで)のサマリです。

これで大方の議論をおさえたところで、興味・関心あれば
ぜひともメイリングリストへの参加をお勧めします。
一応、原文を添付します。

初回ということでruby-listにお披露目しますが、次回からの
サマリは適当なMLに移すことも考えています。(rubyist?)
ご意見お寄せ下さい。
-- 
SugHimsi == SUGIHARA Hiroshi
[e-mail]
間接的なフィードバックに飽き足らなければ、ぜひ参加を!

[ruby-doc:00071] WeRDS, the Weekly Ruby-Doc Summary, for 2002-09-13
2002年09月13日時点のWeRDS (the Weekly Ruby-Doc Summary) です。
今週はJames Brittがお届けします。

(今回はWeeklyといいながら、実のところもう少し広く、先週にruby-doc
 メイリングリスト[訳者註1]ができてこのかた全てのメッセイジを対象に
 含んでいます。)

    [註1]
        ruby-docメイリングリストへの参加方法は:
        <[e-mail]>に、本文
        subscribe YourFamilyName YourFirstName
        のみで送信、同アドレスからの返信の指示に従います。

    発表(Announcements)
    ===================

    ruby-docメイリングリストがつくられました
        Rubyドキュメント化プロジェクトをサポートするためのメイリング
        リストがつくられた。これはruby-talkのメイル[ruby-talk 48584]
        からはじまるスレッドから育ったもので、[ruby-talk 49080]にて
        Jim Freeze氏が、勇敢にも自らドキュメント標準化プロジェクトの
        先頭に立つことを表明するに至った。[註2]
    [註2] この[ruby-talk 49080]の拙訳は[rubyist:1470]。

    Ruby-Doc要求事項を文書化しました
        Jim Freeze氏が要求事項を文書化した[2]ことを伝えた。その内容に
        ついて、明確にすべきこと、省くべきことなどの議論が行われて
        いる。
    [2] http://www.freeze.org/rdp/

    rubydoc.orgへのアクセス
        www.rubydoc.orgをメンテナンスされているSean Chittenden氏が
        メイリングリストに加わり、このドキュメント化プロジェクトの
        ためにrubydoc.orgのアカウントを提供しようと意志表明した。

    主なスレッド(Threads)
    =====================

    今あるRDPは、どんな状況なんですか?
        Jim Freeze氏は、下記[0]主宰のRuby Documentation Projectに
        ついてMatz氏に訊ねました。サイトのオーナーに出したE-mailに
        返事がなかった[註3]ためです。
    [0] http://www.ruby-lang.org/~rubikitch/RDP-en.cgi?cmd=view;name=top
    [註3] …そうな。その後るびきち氏はメイリングリストに参加しました。

    ここの議事予定表はありますか?
        Gavin Sinclair氏は、議事予定表はどんなだったろうかと訊ねた。
        これをきっかけに、皆が考えやコメントを出し合って、ついに
        Jim Freeze氏が、正式な要求事項を一式、用意することになった。
        (これらの要求事項は、最終的に、いつかの週に発表しましょう。)

    自己紹介
        いろいろと参加メンバーの自己紹介がなされた。なかみは、名前と
        所在と実力と経験と、といったところ。

    出力フォーマット、道具選び
        Rubyドキュメント化の道具(RDocとかRDtoolとか)として、どんな
        フォーマットを選んだら良さそうか、が議論された。
        当然、XMLの可能性も話に登ったが、他の選択肢として、HTML、
        riに取り込めるようなもの、そしてmanなども挙がった。

    いま遊べるのは…
        どんなものがあるかな?  どんな道具が使えるかな?
        RDocは遠からずRubyに標準添付されるであろうと思われる。

    みんなでRubyカンファレンスに行こう
        Jim Freeze氏は、誰かRubyカンファレンスに参加しないか、そして
        そこでうまいことruby-docリストのメンバーが集まれないだろうか、
        と気をもんでいる。

    今あるRDPのウェブサイトの役割は
        Jim Freeze氏は、RDPのウェブサイト[1]と今ここでの努力[議論等]と
        歩調を合わせてゆくにはどうしたらいいか、また英語日本語どちらの
        話し手にも確実にドキュメントを届けるためにはどうしたらよいのか、
        と投げかけた。
    [1] http://www.ruby-lang.org/~rubikitch/RDP-en.cgi

    ドキュメント化のウェブサイトをホストしよう
        上記、要求事項のスレッドから発展して、ドキュメントをウェブから
        参照できるようにしたほうがいいのか、するならどこかいい場所が
        あるか、どのように実行するか、といった議論になった。

    メイリングリストのアーカイヴは?
        James Britt氏は、このruby-docのメイリングリストも、ruby-talk
        だとかのように、どこかにアーカイヴしてくれている場所があるのか
        どうか訊ねてみた。はっきりいって、今は「ありません」[註4]。
    [註4] だからこんな作業をしている(^^;)


はい、今週はここまで!