fix(docs): add documentation about running C++ gRPC bindings (#782)

Benjamin E. Coe · web-flow · commit bdc690e6d102 · 2019-10-15T17:21:41.000-07:00
diff --git a/.readme-partials.yml b/.readme-partials.yml
@@ -8,3 +8,19 @@ introduction: |-
         [Pub/Sub quickstart](https://cloud.google.com/pubsub/docs/quickstart-client-libraries),
         [publisher](https://cloud.google.com/pubsub/docs/publisher), and [subscriber](https://cloud.google.com/pubsub/docs/subscriber)
         guides.
+body: |-
+        ## Running gRPC C++ bindings
+
+        For some workflows and environments it might make sense to use the C++ gRPC implementation,
+        instead of the default one (see: [#770](https://github.com/googleapis/nodejs-pubsub/issues/770)):
+
+        To configure `@google-cloud/pubsub` to use an alternative `grpc` transport:
+
+        1. `npm install grpc`, adding `grpc` as a dependency.
+        1. instantiate `@google-cloud/pubsub` with `grpc`:
+
+           ```js
+           const {PubSub} = require('@google-cloud/pubsub');
+           const grpc = require('grpc');
+           const pubsub = new PubSub({grpc});
+           ```
diff --git a/README.md b/README.md
@@ -79,7 +79,21 @@ async function quickstart(
 }
 
 ```
+## Running gRPC C++ bindings
 
+For some workflows and environments it might make sense to use the C++ gRPC implementation,
+instead of the default one (see: [#770](https://github.com/googleapis/nodejs-pubsub/issues/770)):
+
+To configure `@google-cloud/pubsub` to use an alternative `grpc` transport:
+
+1. `npm install grpc`, adding `grpc` as a dependency.
+1. instantiate `@google-cloud/pubsub` with `grpc`:
+
+   ```js
+   const {PubSub} = require('@google-cloud/pubsub');
+   const grpc = require('grpc');
+   const pubsub = new PubSub({grpc});
+   ```
 
 
 ## Samples
