improve connector documentation