improve docs again