clarification of docs