Doc and readme updates

Plese check if README.md is good