Add infinite state/subscription descriptions

Author: markerikson

docs/rtk-query/api/created-api/hooks.mdx

@@ -785,8 +785,22 @@ type UseQuerySubscriptionResult = {
 
 ### `useInfiniteQueryState`
 
+```ts title="Accessing a useInfiniteQueryState hook" no-transpile
+const useInfiniteQueryStateResult =
+  api.endpoints.getManyPosts.useInfiniteQueryState(arg, options)
+```
+
+[summary](docblock://query/react/buildHooks.ts?token=UseInfiniteQueryState)
+
 ### `useInfiniteQuerySubscription`
 
+```ts title="Accessing a useInfiniteQuerySubscription hook" no-transpile
+const useInfiniteQuerySubscriptionResult =
+  api.endpoints.getManyPosts.useInfiniteQuerySubscription(arg, options)
+```
+
+[summary](docblock://query/react/buildHooks.ts?token=UseInfiniteQuerySubscription)
+
 ### `useLazyQuerySubscription`
 
 ```ts title="Accessing a useLazyQuerySubscription hook" no-transpile

packages/toolkit/src/query/react/buildHooks.ts

@@ -918,6 +918,16 @@ export type UseInfiniteQuery<
     'fetchNextPage' | 'fetchPreviousPage'
   >
 
+/**
+ * A React hook that reads the request status and cached data from the Redux store. The component will re-render as the loading status changes and the data becomes available.
+ *
+ * Note that this hook does not trigger fetching new data. For that use-case, see [`useInfiniteQuery`](#useinfinitequery) or [`useInfiniteQuerySubscription`](#useinfinitequerysubscription).
+ *
+ * #### Features
+ *
+ * - Returns the latest request status and cached data from the Redux store
+ * - Re-renders as the request status changes and data becomes available
+ */
 export type UseInfiniteQueryState<
   D extends InfiniteQueryDefinition<any, any, any, any, any>,
 > = <R extends Record<string, any> = UseInfiniteQueryStateDefaultResult<D>>(
@@ -941,6 +951,20 @@ export type TypedUseInfiniteQueryState<
   >
 >
 
+/**
+ * A React hook that automatically triggers fetches of data from an endpoint, and 'subscribes' the component to the cached data. Additionally, it will cache multiple "pages" worth of responses within a single cache entry, and allows fetching more pages forwards and backwards from the current cached pages.
+ *
+ * The query arg is used as a cache key. Changing the query arg will tell the hook to re-fetch the data if it does not exist in the cache already.
+ *
+ * Note that this hook does not return a request status or cached data. For that use-case, see [`useInfiniteQuery`](#useinfinitequery) or [`useInfiniteQueryState`](#useinfinitequerystate).
+ *
+ * #### Features
+ *
+ * - Automatically triggers requests to retrieve data based on the hook argument and whether cached data exists by default
+ * - 'Subscribes' the component to keep cached data in the store, and 'unsubscribes' when the component unmounts
+ * - Caches multiple pages worth of responses, and provides methods to trigger more page fetches forwards and backwards
+ * - Accepts polling/re-fetching options to trigger automatic re-fetches when the corresponding criteria is met
+ */
 export type UseInfiniteQuerySubscription<
   D extends InfiniteQueryDefinition<any, any, any, any, any>,
 > = (