yard-contracts

https://github.com/sfcgeorge/yard-contracts

This YARD plugin uses Contracts and method signatures, merged with your optional docstring to automatically generate parameter documentation with type and description. It does the same for return.