add type when add couple; clean up docs