updated error in docs
Added a complete description of the features to the readme
updated examples to javascript, rather than coffee-script
Added coffee-jshint before running tests