added documentation to allow using capistrano from ruby script

This is the documentation for: https://github.com/capistrano/capistrano/pull/819 and using capistrano in ruby script.