Docs in readme, cleaned code comments.

Add build and npm module badges.
Keep function params same as jsdocs.


Just to keep track of code comments. If I do anything like this in the future I'll just do it in PR form because it is far more sane.

EDIT: eff. I screwed this up pretty bad.

See: 12b8d58 & 4b85f3e