Ruby/Railsのコードを読むにはroccoとrdefsが便利：Rails Hub情報局：エンジニアライフ

新年明けましておめでとうございます。今年こそRuby/Railsをやってみようという人もいるかと思います。ここではRubyのコードを読むのに便利なツールを2つほどご紹介したいと思います。 ドキュメント生成ツールのRD、RDoc、SDoc ソースコードに埋め込んだコメントを、そのままドキュメントとして抽出するツールがRubyにはいろいろあります。いちばん古くからあるのは、RD（Ruby Document Format）と呼ばれるもので、Markdownなどと同様に構造を記述できます。 現在、Rubyに標準添付されているのはRDocです。RubyのソースコードからHTML＋CSS＋JavaScriptを吐き出して、ブラウザで閲覧しやすくしてれます。もう1つ、RDocに似たものにSDocがあります。Sはsearchableのことで、ブラウザ上でクラスやメソッド名をインクリメンタル検索できるのが特

[kitokitoki]

kmori って僕です。言及ありがとうございます..

[stealthinu]

rubyやcoffeeのソースからコメントやクラスの自動抽出閲覧ツール。ぱっとソース全体の把握をするために。

[rochefort]

rdefs gem化されてたのか

[hellowhellow]

これ便利!!

[ma2]

「事後承諾を得てGem化」って言い回しはおかしい気がします。

[new3]

　RoRの時是非

[itsumu126]

“Rails Hub情報局: Ruby/Railsのコードを読むにはroccoとrdefsが便利”

[warriorking]

Rails Hub情報局: Ruby/Railsのコードを読むにはroccoとrdefsが便利

[griefworker]

roccoを使えばrbファイルからHTMLファイルを生成できる。

[t-wada]

便利そう! "最近のRuby/Rails文化では、コメントが丁寧に書かれる傾向があるように感じています。かなりの量の文書が埋め込まれていて、ファイルによってはコード量よりも文書のほうが多いことも" そうなんですよね

[todesking]

doccoみたいなインタフェースよさそう

[migrs]

vim なら unite-outline ですね https://github.com/h1mesuke/unite-outline/wiki

[udzura]

おおお…便利……

[yamaeda]

Rails Hub情報局: Ruby/Railsのコードを読むにはroccoとrdefsが便利 -

[o_show]

コードと(コードに埋め込んだ)ドキュメントを左右に並べてブラウザで表示できるDoccoというのがあり、そのRuby版のRoccoがある

[mallowlabs]

ドキュメント生成