Improve readability

* Make long sentences easier to understand by breaking them into
  shorter sentences.
* Consistently use : before anounced examples.
* Make overall document style more consistent.
* Minor grammar fixes.
fixed capistrano documentation links
Merge branch 'master' of brki/capistrano-handbook

Conflicts:
	index.markdown