move html/js files to resources/www
README wording and project.clj metadata touch-ups
remove dead code and comment
add more docstrings and trivial refactoring/var renaming