Add some doc blocks to retry link

Author: jerelmiller

src/link/retry/retryLink.ts

@@ -14,6 +14,9 @@ import type { RetryFunction, RetryFunctionOptions } from "./retryFunction.js";
 import { buildRetryFunction } from "./retryFunction.js";
 
 export declare namespace RetryLink {
+  /**
+   * Options provided to the `RetryLink` constructor.
+   */
   export interface Options {
     /**
      * Configuration for the delay strategy to use, or a custom delay strategy.
@@ -104,6 +107,31 @@ class RetryableOperation {
   }
 }
 
+/**
+ * `RetryLink` is a non-terminating link that attempts to retry operations that
+ * fail due to network errors. It enables resilient GraphQL operations by
+ * automatically retrying failed requests with configurable delay and retry
+ * strategies.
+ *
+ * @remarks
+ *
+ * `RetryLink` is particularly useful for handling unreliable network conditions
+ * where you would rather wait longer than explicitly fail an operation. It
+ * provides exponential backoff and jitters delays between attempts by default.
+ *
+ * > [!NOTE]
+ * > This link does not handle retries for GraphQL errors in the response. Use
+ * > `ErrorLink` to retry an operation after a GraphQL error. For more
+ * > information, see the [Error handling documentation](https://apollographql.com/docs/react/data/error-handling#on-graphql-errors).
+ *
+ * @example
+ *
+ * ```ts
+ * import { RetryLink } from "@apollo/client/link/retry";
+ *
+ * const link = new RetryLink();
+ * ```
+ */
 export class RetryLink extends ApolloLink {
   private delayFor: DelayFunction;
   private retryIf: RetryFunction;