more documentation clarification