Docs

Adding comments and RDoc to public API gem. 

rake doc:generate ftw!