Added images for documentation

Also updated .gitignore not to ignore doc, and gemspec to ignore doc
updated README