doc edits with example