Improve the PreparedRequest docs.

In response to some of the discussion in #1698. Looking for review from @sigmavirus24. =)