<p>I just read through most of the docs. At least in DBIx::Class::Manual::Joining, it is clear that table names are not used. Looking at other 'cookbook' style docs in cpan shows they are normally more of a hodgepodge of examples and documentation. In this case I think a little bolding of certain words and concepts are warranted and doesn't lead to fragmentation. Your call on a merge.</p>

<p style="font-size:small;-webkit-text-size-adjust:none;color:#666;">&mdash;<br>Reply to this email directly or <a href="https://github.com/dbsrgits/dbix-class/pull/80#issuecomment-121733586">view it on GitHub</a>.<img alt="" height="1" src="https://github.com/notifications/beacon/AASeAvUM2Eys4W3oRSI4ykGFQOj1kM7mks5odrdxgaJpZM4FXGSj.gif" width="1" /></p>
<div itemscope itemtype="http://schema.org/EmailMessage">
  <div itemprop="action" itemscope itemtype="http://schema.org/ViewAction">
    <link itemprop="url" href="https://github.com/dbsrgits/dbix-class/pull/80#issuecomment-121733586"></link>
    <meta itemprop="name" content="View Pull Request"></meta>
  </div>
  <meta itemprop="description" content="View this Pull Request on GitHub"></meta>
</div>