Use Yard (see ...) syntax

Based on the results of
https://github.com/lsegal/yard/issues/720#issuecomment-38344444 the
Yard (see ...) syntax suits our needs.  This change updates all of our
docs to remove the macros and instead use that syntax.

[#68083978]
Merge 68083978-yard-see-syntax to master

[Completes #68083978]