If you wrap alternative method suggestions in `{}` yard will auto-link them, see: http://rubydoc.info/gems/yard/file/docs/Tags.md#deprecated