DOC-12152

waitUntilReady

Author: RichardSmedley

modules/ref/pages/client-settings.adoc

@@ -16,7 +16,27 @@ Full details can be found in https://docs.couchbase.com/sdk-api/couchbase-node-c
 
 // section on wide area network support
 
-include::{version-common}@sdk:shared:partial$client-settings-wide-network.adoc[]
+== Commonly Used Options
+
+The defaults above have been carefully considered and in general it is not recommended to make changes without expert guidance or careful testing of the change.
+Some options may be commonly used together in certain envionments or to achieve certain effects.
+
+=== Constrained Network Environments
+
+Though xref:project-docs:compatibility.adoc#network-requirements[wide area network] (WAN) connections are not directly supported, some development and non-critical operations activities across a WAN are convenient.
+Most likely for connecting to Couchbase Capella, or Server running in your own cloud account, whilst developing from a laptop or other machine not located in the same data center.
+These settings are some you may want to consider adjusting:
+
+* Connect Timeout to 30s
+* Key-Value Timeout to 5s
+* Config Poll Interval to 10s
+* Circuit Breaker ErrorThresholdPercentage to 75
+
+NOTE: As of SDK API 3.4 you can also use a *Configuration Profile*, which allows you to quickly configure your environment for common use-cases.
+See the <<configuration-profiles>> section for more details.
+
+// the below is the above with WaitUntilReady added - which is not in the Node.js SDK.
+// include::{version-common}@sdk:shared:partial$client-settings-wide-network.adoc[]
 
 == Configuration Profiles