tag:rubydoc.tenderapp.com,2010-12-26:/discussions/problems/410-docs-brokensRubydoc.info: Discussion 2015-10-22T19:22:38Ztag:rubydoc.tenderapp.com,2010-12-26:Comment/382718662015-10-22T19:22:36Z2015-10-22T19:22:36Zdocs brokens<div><p>Hi there,</p>
<p>The full error is a 404</p>
<blockquote>
<p>Sorry, but we couldn't find the page
/gems/rr/doc/01_test_double.md in the rr gem. Are you sure that
class, method, or file exists?</p>
</blockquote>
<p>Looking at the file list in the <code>rr</code> gem, it looks
like those md files are not actually defined in the project as
extra files.</p>
<p>My guess is you got to those pages via broken links in the
README? <a href="https://raw.githubusercontent.com/rr/rr/master/README.md">Lookng
at the README.md</a>, I can see usage of relative URLs, which is
not a reliable way to link to files. Instead, I would recommend
opening an issue on the project's GitHub page to let them know of
these broken links and suggest using
<code>{file:doc/01_test_double.md}</code> syntax in addition to
marking these as extra files <a href="http://www.rubydoc.info/gems/yard/file/docs/GettingStarted.md#Documenting_Extra_Files">
via the <code>.yardopts</code> file</a> (you would put <code>-
doc/*.md</code> into the <code>.yardopts</code> file).</p></div>lsegal