fix some yard markup

Now we have a clean `rake yard` run

Changes:
Fix @tags:
  @returns > @return
  @options > @option
  @params > @param
  @method > @overload
  'Examples' > @example
Fix attribute names
Fix Hash style
Fix comments