more docs clarification