I should have been using RDOC earlier, but I guess better late than never.

It seems fairly simple to generate RDOC documentation in a Rails application:
rake appdoc
However, I understand that RDOC has the facility to detect comments in the code and add them to the documentation pages. However, I can't see how to either tell RDOC to include my comments, or flag the comments so that RDOC will use them. How do I get RDOC to identify and post my comments into the documentation?

Finding a solution isn't helped by the fact that seaching for help on RDOC documentation leads to lots of links to documentation created with RDOC.