suggestions for README and documentations

What do you think?