Improve interaction handler docs
Improve interaction handler docs

As discussed in #260, remove broken stateful example, add information about the data parameter, general typo / readability improvements
capistrano/sshkit,mikz/sshkit,robd/sshkit