documentation clarification