improve readme wording
improve variable naming