update doc with more straightforward description