README: more details on params, some grammar cleanup
README: added some best practices