Using this an example to ask about preferred style and presentation.  In Runcible we added similar documentation and I found that formatting the documentation, just like any other type of prose, made it much easier and quicker to consume.  Thus my question, given the above, I find what's below to be cleaner and easier to read:

`
# @param [Hash] options This helper accepts the following options:
# @option            options :by the name of the named scope. This helper will prepend this value with "ascend_by_" and "descend_by_"
# @option            options :as the text used in the link, defaults to whatever is passed to :by
`

or

`
# @param [Hash]  options This helper accepts the following options:
# @option options :by the name of the named scope. This helper will prepend this value with "ascend_by_" and "descend_by_"
# @option options :as the text used in the link, defaults to whatever is passed to :by
`