add clarification for documentation