fix docs and implementation of utils