readme and comment updates