minor code formatting
readme: updated how it works section
Merge remote-tracking branch 'origin/master'