Readme and commentary updates