updated doctoring in `add`