This is YARD comments. I hope that someday we will be able to generate cool and helpful YARD documentation.

That's why such comments seems helpful to me. Probably, in that particular case I had to add more description.