add more tests for template render and assets
increases coverage to 94%
add usage docs
add genindex entries and better toc
README is less now