expanded a bit the notes in the readme.