improve types docs