updated README, improved variable naming