make documetation generate again

* prevents exceptions when generating shell examples
* prevents exception when defining @option on a module
* use latest yard
* replace rdoc in rakefile
change :nodoc: to @private
generate doc for configuration options
improve documentation of namespaced class inputs
Merge pull request #1101 from mikz/improve-namespaces-docs

Improve documentation