updated the docs to be more clear