rails/rails — comment on commit 0306f82e0c3cda3aad1b45eb0c3a359c254b62cc
File: railties/lib/rails/generators/rails/app/templates/config/environments/development.rb.tt line 31
By fxn:

We will need to agree in that we disagree :).

For a public API, you can read "in_seconds" either in the parameter name or the documentation. It's about the same effort. And you are not even going to write the parameter name! But on the other hand having the units in the parameter name has consequences explained above I believe outweight the benefits of a shorter name.

There's always a trade-off. C programmers have avoided vowels for decades to short variable names, and we value today find_by_email_and_active. It is long, it is verbose, but it is absolutely clear. And we love that.

I see your point about "threshold". There are a lot of libraries that have connection.threshold or somesuch, and when I see them or source code using them open wondering points start to appear unnecessarily in my mind.

So, I really understand what's your point of view, but se think differently about it in this particular case.