Readme and commentary update