koraktor / rubikon

A simple to use, yet powerful Ruby framework for building console-based applications.
http://koraktor.github.com/rubikon
BSD 3-Clause "New" or "Revised" License
93 stars 2 forks source link

YARD plugin for Rubikon app documentation #7

Open koraktor opened 14 years ago

koraktor commented 14 years ago

Apps using Rubikon should be easily documentable with YARD.

This would need a YARD plugin that does the following:

So an example application may look like this:

class App < Rubikon::Application::Base

  # This is a flag and does nothing
  flag :f
  # This is an option and does even less
  # @arg [String] arg There is an argument to this option, but it is useless
  option :opt, 1
  # This command is competely useless, but it's fully documented
  # @arg [Number] This is the uselessness of this command
  command :cmd, 1 do
  end

end
koraktor commented 13 years ago

I'm working on this in yard-rubikon.