keeping jshint happy and updating the docs