update the readme

- more detail
Merge remote-tracking branch 'origin/master' into dev