Update docs to highlight the value of r.encoding.
Merge pull request #1823 from Lukasa/moredocs

Update docs to highlight the value of r.encoding.