Implement Brian's feedback
Improved variable names and documentation
Merge branch 'feature/readability-efficiency'