added some clarification in docs