adds new comments to control flow, clears up module responsibilities