improve(project): improved comments & made helper function private