Documentation in Rails with sdoc

Jan 23, 2018 by ohiodn8

In Gemfile =>

gem 'sdoc'

Then run (via cmd) =>

sdoc -o doc/rails_app

Just that is fine, and you can check your generated documentation file at /doc/rails_app/index.html, but we want our documentation to look a bit organized (and without the test folder).

Use the task generator to create a new namespace:

rails g task rdoc

Open /lib/tasks/rdoc.rake. In there, you'll find => 

namespace :rdoc do

end

Replace that with the code below:

require 'sdoc'
require 'rdoc/task'

RDoc::Task.new do |rdoc|
  rdoc.rdoc_dir = 'doc/rdoc'
  rdoc.generator = 'sdoc'
  rdoc.template = 'rails'
  rdoc.rdoc_files.include('Gemfile', 'README.md', 'app/', 'db/', 'lib/')
end

You can run (in cmd) rails rdoc, and open doc/rdoc/index.html in your browser . . . to update the documentation, run rails rerdoc

Sdoc Documentation Page

Image by =>

Comments