added explanation for intention for this file after refactoring