doc nits re: caveats.  Broken anchor link.
Merge pull request #6139 from rolandwalker/doc_nit_anchor

doc nits re: caveats.  Broken anchor link.