refine and document utils module