some useful notes in the readme