update readme with comment additions