Docs clarification & update