readme and comment improvements