diff --git a/packages/vow/src/types.ts b/packages/vow/src/types.ts
index dee2d14531f4..46c7cb293ba4 100644
--- a/packages/vow/src/types.ts
+++ b/packages/vow/src/types.ts
@@ -142,6 +142,15 @@ export type VowTools = {
     fn: (...args: any[]) => Vow<Awaited<T>> | Awaited<T> | PromiseVow<T>,
   ) => Vow<Awaited<T>>;
   makeVowKit: <T>() => VowKit<T>;
+  /**
+   * Create a function that retries the given function if the underlying
+   * async function rejects due to an upgrade disconnection. The return value
+   * of the created function is a vow that settles to the final retry result.
+   *
+   * @param fnZone the zone for the named function
+   * @param name base name to use in the zone
+   * @param fn the retried function
+   */
   retriable: <F extends (...args: any[]) => Promise<any>>(
     fnZone: Zone,
     name: string,