Update README and update some in-line documentation