Major updates to the README. Minor code comment updates