fix some typos
add examples to README, some doc improvements