improved intuitive docs through variable naming