updated docs for users