doc nits re: caveats.  Broken anchor link.