(doc) Clean up YARD lint

Fix mis-matched `@param` tags, use of non-existant tags and unresolvable links.