some comments and minor fixes
readme