How to generate docs for my models and controller in rails

Question

I want to create docs for the models and controller of my application. Even for rake task, any background job. As I have thousands of lines of comments inline between the code, explanation of the all the functions actions..

I don't want docs for rails so

  rake doc:rails 

is useless for me.

Usecase is internal detailed developer notes.

Answer 1

Try using this rake task:

rake doc:app

This task is provided by Rdoc. It also supports some markup that you can use to make things look better when formatted. You can see examples in the documentation.