minor documentation improvements
readme improvements