Bug is here:

http://rubydoc.tenderapp.com/discussions/problems/348-includefilereadmemd-including-rubydocinfos-readmemd-not-the-readmemd-in-my-gem

Perhaps this is the answer:

docmeta/rubydoc.info#30

And I just need to notate this in my .yardopts file (which will
be needed in the gem I suppose).

Will test this out via

http://www.rubydoc.info/github/rampion/Flexibility/Flexibility