[Closes #144] Improve Capistrano integration docs.

 - Improve correspondance between the list of integration choices and the
   instructions below: links and terminology
 - Tighten documentation to make it clearer and faster to read.
 - Where possible, re-format Ruby code to avoid horizontal scrolling