Update retry link

Author: jerelmiller

docs/source/api/link/apollo-link-retry.mdx

@@ -1,57 +1,19 @@
 ---
-title: Retry Link
+title: RetryLink
 description: Attempt an operation multiple times if it fails due to network or server errors.
 ---
 
-## Overview
+<DocBlock
+  canonicalReference="@apollo/client/link/retry!RetryLink:class"
+  customOrder={["summary", "remarks", "example"]}
+/>
 
-`@apollo/client/link/retry` can be used to retry an operation a certain amount of times. This comes in handy when dealing with unreliable communication situations, where you would rather wait longer than explicitly fail an operation. `@apollo/client/link/retry` provides exponential backoff, and jitters delays between attempts by default.
-
-> **Note:** It does not currently handle retries for GraphQL errors in the response, only for network errors; the `onError` link can be used to retry an operation after a GraphQL error. For more information, see the [Error handling documentation](/react/data/error-handling/#on-graphql-errors).
-
-An example use case is to hold on to a request while a network connection is offline, and retry until it comes back online.
-
-```js
-import { RetryLink } from "@apollo/client/link/retry";
-
-const link = new RetryLink();
-```
-
-## Options
-
-The standard retry strategy provides exponential backoff with jittering, and takes the following options, grouped into `delay` and `attempt` strategies:
-
-### options.delay
-
-| Option          | Description                                                                 |
-| --------------- | --------------------------------------------------------------------------- |
-| `delay.initial` | The number of milliseconds to wait before attempting the first retry.       |
-| `delay.max`     | The maximum number of milliseconds that the link should wait for any retry. |
-| `delay.jitter`  | Whether delays between attempts should be randomized.                       |
-
-### options.attempts
-
-| Option             | Description                                                                              |
-| ------------------ | ---------------------------------------------------------------------------------------- |
-| `attempts.max`     | The max number of times to try a single operation before giving up.                      |
-| `attempts.retryIf` | A predicate function that can determine whether a particular response should be retried. |
-
-### Default configuration
-
-The default configuration is equivalent to:
+## Constructor signature
 
 ```ts
-new RetryLink({
-  delay: {
-    initial: 300,
-    max: Infinity,
-    jitter: true,
-  },
-  attempts: {
-    max: 5,
-    retryIf: (error, _operation) => !!error,
-  },
-});
+constructor(
+  options?: RetryLink.Options
+): RetryLink
 ```
 
 ## Avoiding thundering herd
@@ -68,15 +30,34 @@ Instead of the options object, you may pass a function for `delay` and/or `attem
 
 The `attempts` function should return a `boolean` (or a `Promise` which resolves to a `boolean`) indicating whether the response should be retried. If yes, the `delay` function is then called, and should return the number of milliseconds to delay by.
 
-```js
-import { RetryLink } from "@apollo/client/link/retry";
-
-const link = new RetryLink({
-  attempts: (count, operation, error) => {
-    return !!error && operation.operationName != "specialCase";
-  },
-  delay: (count, operation, error) => {
-    return count * 1000 * Math.random();
-  },
-});
-```
+## Types
+
+<InterfaceDetails
+  canonicalReference="@apollo/client/link/retry!DelayFunction:interface"
+  headingLevel={3}
+  displayName="DelayFunction"
+/>
+
+<InterfaceDetails
+  canonicalReference="@apollo/client/link/retry!RetryFunction:interface"
+  headingLevel={3}
+  displayName="RetryFunction"
+/>
+
+<InterfaceDetails
+  canonicalReference="@apollo/client/link/retry!RetryLink.Options:interface"
+  headingLevel={3}
+  displayName="RetryLink.Options"
+/>
+
+<InterfaceDetails
+  canonicalReference="@apollo/client/link/retry!DelayFunctionOptions:interface"
+  headingLevel={3}
+  displayName="DelayFunctionOptions"
+/>
+
+<InterfaceDetails
+  canonicalReference="@apollo/client/link/retry!RetryFunctionOptions:interface"
+  headingLevel={3}
+  displayName="RetryFunctionOptions"
+/>