updated doc strings [ci skip]
refactor util class and more docs [ci skip]