some more doc edits (looks like doc writing never ends)