[CB-3962] clarify passive-voice better for reference doc