attempt to comment heavily composed functions