lsegal / yard

YARD is a Ruby Documentation tool. The Y stands for "Yay!"
http://yardoc.org
MIT License
1.92k stars 396 forks source link

include references in README #290

Closed schmurfy closed 13 years ago

schmurfy commented 13 years ago

Hi, Yard is really nice but I wish I could include parts of the documentation for specific methods/class in the README to avoid repeating it, basically what I try to do is:

# title

  blablabla
  (see #method_with_example)

Is there any way to do this ? (my README is name README.md and rendered accordingly with bluecloth)

lsegal commented 13 years ago

You can look at the available yardoc formatting syntax in the Getting Started guide, specifically inter-document linking. http://rubydoc.info/docs/yard/file/docs/GettingStarted.md#Inter-document_Linking

FYI the mailing list is a better place to ask questions: yardoc@googlegroups.com

schmurfy commented 13 years ago

thanks, I was not sure where to ask this :>