From: Intransition <transfire@...>
Date: 2009-10-09T01:08:16+09:00
Subject: Documenting DSLs

Has anyone done any work on documenting Ruby DSLs? Eg. RDoc can
document this:

  # This plugin ...
  class MyThing < Plugin
     # This does ...
     def some
       ...
     end
  end

But if one were to make a DSL out of it, say:

  # This plugin ...
  plugin 'MyThing' do
    # This does ...
    define 'some' do
      ...
    end
  end

Then no RDocy.