doc: proper rubydoc param documentation