Rough documentation of Client usage aspects

1 files changed, 19 insertions, 1 deletions

diff --git a/docs/client.rst b/docs/client.rst
index 9a9bc23..684d3ab 100644
--- a/docs/client.rst
+++ b/docs/client.rst
@@ -1,3 +1,21 @@
 ======
 Client
-======
\ No newline at end of file
+======
+
+Unicode Everywhere
+------------------
+
+OAuthLib expects you to supply all string-like parameters in unicode. If you're
+using bytestrings in your library, make sure to do a proper conversion to unicode
+before sending the strings to oauthlib.
+
+Request body
+------------
+
+The OAuth 1 spec only covers signing of x-www-url-formencoded information. If
+you are sending some other kind of data in the body (say, multipart file uploads),
+these don't count as a body for the purposes of signing. Don't provide the body
+to Client.sign() if it isn't x-www-url-formencoded data.
+
+For convenience, you can pass body data in two ways: as a dictionary, or as a
+properly-formatted x-www-url-formencoded string.