set descriptive variable names + few debuging statements
added more details in the README file