improved documentation and other site tweaks
improved documentation [skip ci]
formatting tweaks [skip ci]
Tweaked README [skip ci]
updated version in pom