Fix YARD docs

MSP-9816

Work around bug in YARD 0.8.7.3 where `attr_reader <name>` after an `@!attribute [r] <name>`
causes the `@!attribute` docs to be suppressed.  Fix see inclusion by
using correct (see) form instead of @see (see also) for documenting
diagram methods.