title: yard and links to classes/modules in the doc
body: <p>I'm currently switching from rdoc to yard for my ruby software documentaion.</p>
  
  <p>In my doc I often reference some classes/modules from the comments, for instance : </p>
  
  <pre><code>## == Provides various utility features
  ##
  ## == Features
  ##
  ## Logging : logging is provided by the Mysoft::Mypackage::Utility::Logger class
  ##
  </code></pre>
  
  <p>Rdoc correctly creates a link to the Mysoft::Mypackage::Utility::Logger class documentation page, while yard ignores the tag and considers the class name as simple string.</p>
  
  <p>I know that yard has the @see tag, however this will create a separate "See Also" section in the documentation, while I need to reference the class/modules with inside my description text.</p>
  
  <p>I'm surely missing something, but if you have any examples on how this should be done with yard, I'd realy appreciate.</p>
  
  <p>Thanks per advace, </p>
  
  <p>dl</p>