Positional vs. Keyword Arguments in Ruby 2.1.2

[matthutchinson]

Do we have opinions on the new keyword args feature in ruby 2.1.2 - specifically favouring them over methods having an options hash?

Some discussion on this here (which I kind of agree with); http://robots.thoughtbot.com/ruby-2-keyword-arguments

Usually, the code clarity and maintainability gained from keyword arguments outweigh the terseness offered by positional arguments. I would use positional arguments if I could easily guess their meanings based on the method’s name, but I find this rarely to be the case.

Given we're using Ruby 2.1.2 almost everywhere, should we update our Ruby guide to consider this?

[mezis]

We should indeed.

I'ds say:

• avoid using option hashes (it's a smell that you don't have a clear API)
• avoid using more than 1 positional argument (it's error prone)

Care to open a PR?