added examples page and some documentation
damn heroku still not ignoring dev and test gems
remove old examples file and fix link