moved the definitions around, this is no longer used but will stand as a placeholder for future considerations
more documentation to understand rationale