improve docs on utils & df code