improve doc strings of the module
make utils public