fix broken links

Can't use MarkDown hyperlink syntax inside an .rdoc file.
add links to two more projects which recently started using capistrano-spec
Merge pull request #20 from aspiers/master

Fix read world examples links in README.rdoc