docs(solid-query): add summaries to reference pages that render without a description

docs/framework/solid/reference/functions/useMutation.md

@@ -9,7 +9,10 @@ redirect_from:
 function useMutation<TData, TError, TVariables, TOnMutateResult>(options: UseMutationOptions<TData, TError, TVariables, TOnMutateResult>, queryClient?: Accessor<QueryClient>): UseMutationResult<TData, TError, TVariables, TOnMutateResult>;
 ```
 
-Defined in: [packages/solid-query/src/useMutation.ts:173](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useMutation.ts#L173)
+Defined in: [packages/solid-query/src/useMutation.ts:176](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useMutation.ts#L176)
+
+Unlike queries, mutations are typically used to create/update/delete data or perform server side-effects.
+`useMutation` is the function for that.
 
 ## Type Parameters
 

docs/framework/solid/reference/functions/useQuery.md

@@ -11,7 +11,10 @@ redirect_from:
 function useQuery<TQueryFnData, TError, TData, TQueryKey>(options: UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>, queryClient?: () => QueryClient): UseQueryResult<TData, TError>;
 ```
 
-Defined in: [packages/solid-query/src/useQuery.ts:178](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useQuery.ts#L178)
+Defined in: [packages/solid-query/src/useQuery.ts:181](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useQuery.ts#L181)
+
+Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+The query runs when the options call for it — `enabled: false` skips the initial fetch.
 
 ### Type Parameters
 
@@ -212,7 +215,10 @@ function Posts() {
 function useQuery<TQueryFnData, TError, TData, TQueryKey>(options: DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>, queryClient?: () => QueryClient): DefinedUseQueryResult<TData, TError>;
 ```
 
-Defined in: [packages/solid-query/src/useQuery.ts:226](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useQuery.ts#L226)
+Defined in: [packages/solid-query/src/useQuery.ts:232](https://github.com/TanStack/query/blob/main/packages/solid-query/src/useQuery.ts#L232)
+
+Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+The query runs when the options call for it — `enabled: false` skips the initial fetch.
 
 This overload is selected when `initialData` is set, so the resulting `data` is never `undefined`.
 

docs/framework/solid/reference/variables/createMutation.md

@@ -9,6 +9,9 @@ const createMutation: <TData, TError, TVariables, TOnMutateResult>(options: UseM
 
 Defined in: [packages/solid-query/src/index.ts:80](https://github.com/TanStack/query/blob/main/packages/solid-query/src/index.ts#L80)
 
+Unlike queries, mutations are typically used to create/update/delete data or perform server side-effects.
+`useMutation` is the function for that.
+
 ## Type Parameters
 
 ### TData

docs/framework/solid/reference/variables/createQuery.md

@@ -18,6 +18,9 @@ Defined in: [packages/solid-query/src/index.ts:57](https://github.com/TanStack/q
 <TQueryFnData, TError, TData, TQueryKey>(options: UndefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>, queryClient?: () => QueryClient): UseQueryResult<TData, TError>;
 ```
 
+Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+The query runs when the options call for it — `enabled: false` skips the initial fetch.
+
 ### Type Parameters
 
 #### TQueryFnData
@@ -217,6 +220,9 @@ function Posts() {
 <TQueryFnData, TError, TData, TQueryKey>(options: DefinedInitialDataOptions<TQueryFnData, TError, TData, TQueryKey>, queryClient?: () => QueryClient): DefinedUseQueryResult<TData, TError>;
 ```
 
+Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+The query runs when the options call for it — `enabled: false` skips the initial fetch.
+
 This overload is selected when `initialData` is set, so the resulting `data` is never `undefined`.
 
 ### Type Parameters

packages/solid-query/src/useMutation.ts

@@ -12,6 +12,9 @@ import type {
 import type { Accessor } from 'solid-js'
 
 /**
+ * Unlike queries, mutations are typically used to create/update/delete data or perform server side-effects.
+ * `useMutation` is the function for that.
+ *
  * @param options - An accessor returning the {@link UseMutationOptions} to use.
  * @param queryClient - An accessor for a custom `QueryClient`. Otherwise, the one from the nearest context
  * will be used.

packages/solid-query/src/useQuery.ts

@@ -15,6 +15,9 @@ import type {
 } from './queryOptions'
 
 /**
+ * Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+ * The query runs when the options call for it — `enabled: false` skips the initial fetch.
+ *
  * @see {@link queryOptions} to share these options between `useQuery` and imperative APIs like `queryClient.query`.
  * @param options - An accessor returning the {@link UndefinedInitialDataOptions} to use — everything you can
  * pass to `useQuery`.
@@ -186,6 +189,9 @@ export function useQuery<
 ): UseQueryResult<TData, TError>
 
 /**
+ * Subscribes to a query: a declarative dependency on an asynchronous source of data that is tied to a unique key.
+ * The query runs when the options call for it — `enabled: false` skips the initial fetch.
+ *
  * This overload is selected when `initialData` is set, so the resulting `data` is never `undefined`.
  *
  * @see {@link queryOptions} to share these options between `useQuery` and imperative APIs like `queryClient.query`.