VID-2143 Make docs more explicit