added more documentation to index.html; extended README