CON-1942: documentation clarification