Update docs for clarity and accuracy