docs clarification