documentation update

for clarity and accuracy