add doc on utils methods