improve docs/2