update the readme a touch with the current state of the code
re-ran jslint and cleaned up all but one issue - said issue is not major