finish documentation
cleanup code
cleanup markup
make JSHint happy, too