add doc generation and fix missing magic comment in Rakefile
Massive updates to README