added descriptions to some helper functions