fix typos in README and provide better documentation