Update generated source code

Generated SDK source code using:
- Generator version 3.30.0
- Specification version 1.0.0-dev0.0.36
- Automation (cloudant-sdks) version a21bc0a

Author: cloudant-sdks-automation

README.md

@@ -1,3 +1,15 @@
+<!--
+  The example codes and outputs below are generated using the `embedmd` go
+  package.
+
+      https://github.com/campoy/embedmd
+
+  You should regenerate the example codes after making any changes to
+  examples in the test/examples/ folder.
+
+      embedmd -w README.md
+  -->
+
 [![Build Status](https://travis-ci.com/IBM/cloudant-python-sdk.svg?branch=master)](https://travis-ci.com/IBM/cloudant-python-sdk)
 [![Release](https://img.shields.io/github/v/release/IBM/cloudant-python-sdk?include_prereleases&sort=semver)](https://github.com/IBM/cloudant-python-sdk/releases/latest)
 [![Docs](https://img.shields.io/static/v1?label=Pydoc&message=latest&color=blue)](https://ibm.github.io/cloudant-python-sdk/)
@@ -513,22 +525,44 @@ For sample code on handling errors, see
 ### Raw IO
 
 For endpoints that read or write document content it is possible to bypass
-usage of the built-in models and send or receive a bytes response.
-For examples of using byte streams, see the API reference documentation
-("Example request as a stream" section).
+usage of the built-in object with byte streams. 
+
+Depending on the specific SDK operation it may be possible to:
+* accept a user-provided byte stream to send to the server as a request body
+* return a byte stream of the server response body to the user
+
+Request byte stream can be supplied for arguments that accept the `BinaryIO` type.
+For these cases you can pass this byte stream directly to the HTTP request body.
+
+Response byte stream is supported in functions with the suffix of `_as_stream`.
+The returned byte stream allows the response body to be consumed
+without triggering JSON unmarshalling that is typically performed by the SDK.
+
+The [update document](#3-update-your-previously-created-document) section
+contains examples for both request and response byte stream cases.
+
+The API reference contains further examples of using byte streams. 
+They are titled "Example request as stream" and are initially collapsed. 
+Expand them to see examples of:
+
+- Byte requests:
+  - [Bulk modify multiple documents in a database](https://cloud.ibm.com/apidocs/cloudant?code=python#postbulkdocs)
 
-- [Bulk modify multiple documents in a database](https://cloud.ibm.com/apidocs/cloudant?code=python#postbulkdocs)
-- [Query a list of all documents in a database](https://cloud.ibm.com/apidocs/cloudant?code=python#postalldocs)
-- [Query the database document changes feed](https://cloud.ibm.com/apidocs/cloudant?code=python#postchanges)
+- Byte responses:
+  - [Query a list of all documents in a database](https://cloud.ibm.com/apidocs/cloudant?code=python#postalldocs)
+  - [Query the database document changes feed](https://cloud.ibm.com/apidocs/cloudant?code=python#postchanges)
 
 ### Further resources
 
 - [Cloudant API docs](https://cloud.ibm.com/apidocs/cloudant?code=python):
   API reference including usage examples for Cloudant Python SDK API.
 - [Pydoc](https://ibm.github.io/cloudant-python-sdk/):
   Cloudant Python SDK API Documentation.
-- [Cloudant docs](https://cloud.ibm.com/docs/Cloudant?topic=Cloudant-getting-started-with-cloudant):
+- [Cloudant docs](https://cloud.ibm.com/docs/services/Cloudant?topic=cloudant-overview#overview):
   The official documentation page for Cloudant.
+- [Cloudant Learning Center](https://developer.ibm.com/clouddataservices/docs/compose/cloudant/):
+  The official learning center with several useful videos which help you use
+  Cloudant successfully.
 - [Cloudant blog](https://blog.cloudant.com/):
   Many useful articles about how to optimize Cloudant for common problems.