Refactor for Readability

Refactor this code for better readability:

CURRENT CODE:
[Paste your code]

Issues:
- [Specific readability problems]

Constraints:
- Must maintain same functionality
- Must keep same public interface
- [Any other constraints]

Please:
1. Improve variable/function names
2. Extract functions where appropriate
3. Simplify complex conditionals
4. Add clarifying comments only where truly necessary
5. Explain your refactoring decisions