slowly converting the README docs