readme and better method naming