Documentation fixes (YARD warnings)

-Fixed some discrepancies in documentation
-Added Gemnasium badge in README.md