documented code according to golint