docs: Add --exact and ConnectionOptions.interceptors note (#908)

* docs: Add `--exact` and `ConnectionOptions.interceptors` note

* add samples step

Author: lorensr

CONTRIBUTING.md

@@ -192,26 +192,35 @@ for f in ~/Downloads/packages-*.zip; do mkdir "$HOME/Downloads/$(basename -s .zi
 # we should now have all 5 build targets
 ls packages/core-bridge/releases/
 
-npx lerna version patch --force-publish='*' # or major|minor|etc, or leave out to be prompted. either way, you get a confirmation dialog.
+npx lerna version patch --exact --force-publish='*' # or major|minor|etc, or leave out to be prompted. either way, you get a confirmation dialog.
 npx lerna publish from-git # add `--dist-tag next` for pre-release versions
 
 npm deprecate temporalio@^1.0.0 "Instead of installing temporalio, we recommend directly installing our packages: npm remove temporalio; npm install @temporalio/client @temporalio/worker @temporalio/workflow @temporalio/activity"
 ```
 
 - Cleanup after publishing:
 
-```sh
-rm $HOME/Downloads/packages-*
-rm packages/core-bridge/releases/
-```
+  ```sh
+  rm $HOME/Downloads/packages-*
+  rm packages/core-bridge/releases/
+  ```
 
 - If any APIs have changed, open a PR to update [`samples-typescript`](https://github.com/temporalio/samples-typescript/). Once merged, update the `next` branch:
 
-```sh
-git checkout next
-git rebase origin/main
-git push
-```
+  ```sh
+  git checkout next
+  git rebase origin/main
+  git push
+  ```
+
+- While our tests should capture most things, if you want to verify the release works in the samples, do:
+
+  ```sh
+  cd /path/to/samples-typescript
+  lerna exec -- npm update
+  npm run build
+  npm test
+  ```
 
 ### Updating published packages
 

packages/client/src/connection.ts

@@ -53,10 +53,14 @@ export interface ConnectionOptions {
   channelArgs?: grpc.ChannelOptions;
 
   /**
-   * Grpc interceptors which will be applied to every RPC call performed by this connection. By
-   * default, an interceptor will be included which automatically retries retryable errors. If you
-   * do not wish to perform automatic retries, set this to an empty list (or a list with your own
-   * interceptors).
+   * Grpc interceptors which will be applied to every RPC call performed by this connection. By default, an interceptor
+   * will be included which automatically retries retryable errors. If you do not wish to perform automatic retries, set
+   * this to an empty list (or a list with your own interceptors). If you want to add your own interceptors while
+   * keeping the default retry behavior, add this to your list of interceptors:
+   * `makeGrpcRetryInterceptor(defaultGrpcRetryOptions())`. See:
+   *
+   * - @link makeGrpcRetryInterceptor
+   * - @link defaultGrpcRetryOptions
    */
   interceptors?: grpc.Interceptor[];