Don't document methods with malformed parameters

[pavlitsky]

Add basic validation for method's parameters. If they're invalid then don't document either entire method or only skip its parameters.

Bad params examples:

def foo(bar, baz qux)
end

def foo ; end

[pavlitsky]

Also fix param name in this case, it should parse as other, not |other.

  #
  # <Description>
  #
  # @param [<Type>] |other <description>
  #
  # @return [<Type>] <description>
  #
  def |(other)

  end