Updated docs based on Patrick's comments in PR 383.