descriptive names and updated README