[1/2] better docs

index.html rewrite is next

Partial fix for #25.