Update docs to highlight the value of r.encoding.

This should help address the concerns raised in #1795.