readme and comments cleanup