Route 477

■ [ruby][prog] リファレンスとドキュメントの話

反応をいただいた。

• http://d.hatena.ne.jp/ku-ma-me/20090625/p1

僕は説明書はとりあえず一通り目を通してみる方です(笑)。

が、メソッド単位の解説しかないという状態は、ケータイでいう「ぶ厚い方のマニュアル」しか入ってないようなものであり、 そんなもんをいきなりユーザに読ませるのは間違っていて、つまり我々が必要としているのは「ケータイ買ったときに入ってくるペラペラな方のマニュアル」 なのだな。

最近見た例だとerectorの公式サイトが、

• SYNOPSYS SYNOPSIS
• 「User Guide」
• RDoc

と3段階揃ってて良かったです。

■ [haskell] Haskellってこんなにライブラリあったのか

• http://hackage.haskell.org/packages/archive/pkg-list.html

SPONもこうなると良いですね。しかしR6RSの範囲を越えそうなものが結構多いな…