added new helpers and added docblock comments