docs updates following #2650