Adding note about HTTP clients

pzorn · May 22, 2015 · f08e65f · f08e65f
1 parent 22a4f1c
commit f08e65f
Showing 1 changed file with 10 additions and 0 deletions.
diff --git a/docs/getting-started/basic-usage.rst b/docs/getting-started/basic-usage.rst
@@ -120,6 +120,16 @@ Service-specific configuration values are a union of the service-specific
 values and the root-level values (i.e., service-specific values are shallow
 merged onto root level values).
 
+.. tip::
+
+    It is highly recommended that you use the ``Sdk`` class to create clients
+    if you are utilizing multiple SDK clients in your application. The ``Sdk``
+    class will automatically utilize the same HTTP client for each SDK client,
+    allowing SDK clients for different services to perform non-blocking HTTP
+    requests. If the SDK clients do not use the same HTTP client, then HTTP
+    requests sent by the SDK client may cause inter-service promise
+    orchestration to block.
+
 
 Executing service operations
 ----------------------------