more ref updates

Author: LadyBluenotes

src/routes/solid-router/reference/data-apis/action.mdx

@@ -48,8 +48,6 @@ Async function called when the action runs.
 
 When native form handling calls the action, the argument is `FormData` for `multipart/form-data` forms and `URLSearchParams` otherwise.
 
-
-
 ### `options`
 
 - **Type:** `{ name?: string; onComplete?: (submission: Submission<T, U>) => void }`
@@ -62,9 +60,7 @@ Action options.
 - **Type:** `string`
 - **Required:** No
 
-Name used to create the action URL.
-
-The name provides a stable URL for form actions and server rendering.
+Name used to create the action URL when passing an options object.
 
 #### `onComplete`
 

src/routes/solid-router/reference/data-apis/revalidate.mdx

@@ -1,23 +1,17 @@
 ---
 title: revalidate
 use_cases: >-
-  refresh data, invalidate cache, polling, real-time updates, manual refetch,
-  stale data
+  query revalidation, cache invalidation, data refresh
 tags:
   - revalidate
   - cache
-  - refresh
-  - invalidation
-  - polling
-  - refetch
+  - query
 version: "1.0"
 description: >-
-  Manually revalidate cached queries to refresh stale data, implement polling,
-  or trigger updates after mutations in SolidJS.
+  revalidate retriggers router query cache entries.
 ---
 
-The `revalidate` function triggers revalidation of [queries](/solid-router/data-fetching/queries) by their keys.
-Each query with active subscribers re-executes and updates its dependents; queries without subscribers are marked stale but don't execute until subscribed.
+`revalidate` retriggers [`query`](/solid-router/reference/data-apis/query) cache entries inside a transition.
 
 ## Import
 
@@ -41,69 +35,92 @@ function revalidate(
 - **Type:** `string | string[] | void`
 - **Required:** No
 
-The query key or array of query keys to revalidate.
-If not provided, all queries on the current page are revalidated.
+Cache key or keys from a query function's [`key`](/solid-router/reference/data-apis/query#key) or [`keyFor`](/solid-router/reference/data-apis/query#keyfor) property.
 
 ### `force`
 
 - **Type:** `boolean`
-- **Required:** No
 - **Default:** `true`
+- **Required:** No
 
-When `true`, clears the internal cache used for deduplication.
-When `false`, allows cached data to be reused if available.
+When `true`, matching cache entries are marked as cache misses before subscribers are retriggered.
+When `false`, subscribers are retriggered without changing cache entry timestamps.
 
 ## Return value
 
-`revalidate` returns a `Promise` that resolves when the revalidation transition completes.
+- **Type:** `Promise<void>`
+
+Resolves when the revalidation transition completes.
+
+## Behavior
+
+- Runs inside [`startTransition`](/reference/reactive-utilities/start-transition).
+- When `key` is undefined, every cache entry matches.
+- A string or array `key` matches cache entries by key prefix. [`query.key`](/solid-router/reference/data-apis/query#key) targets every cached argument set for that query; [`query.keyFor(...)`](/solid-router/reference/data-apis/query#keyfor) targets one serialized argument list.
+- Matching cache entries update their live signal with the current timestamp, retriggering active cache reads through primitives such as [`createAsync`](/solid-router/reference/data-apis/create-async).
+- Without active subscribers, `revalidate` does not call the query function.
 
 ## Examples
 
 ### Basic usage
 
 ```tsx
-import { query, createAsync, revalidate } from "@solidjs/router";
+import { For } from "solid-js";
+import { createAsync, query, revalidate } from "@solidjs/router";
 
-const getUserQuery = query(async () => {
-	// ... Fetches user data.
-	return { name: "John" };
-}, "user");
+const getTodos = query(async () => {
+	const response = await fetch("/api/todos");
+	return response.json() as Promise<{ id: string; title: string }[]>;
+}, "todos");
 
-function UserProfile() {
-	const user = createAsync(() => getUserQuery());
+function Todos() {
+	const todos = createAsync(() => getTodos(), { initialValue: [] });
 
-	function refreshUser() {
-		revalidate(getUserQuery.key);
+	function refreshTodos() {
+		void revalidate(getTodos.key);
 	}
 
 	return (
-		<div>
-			<button onClick={refreshUser}>Refresh</button>
-			<p>{user()?.name}</p>
-		</div>
+		<>
+			<button onClick={refreshTodos}>Refresh todos</button>
+			<ul>
+				<For each={todos()}>{(todo) => <li>{todo.title}</li>}</For>
+			</ul>
+		</>
 	);
 }
 ```
 
-### Revalidating multiple queries
+### Revalidate a query argument
 
 ```tsx
-import { query, revalidate } from "@solidjs/router";
+import { createAsync, query, revalidate } from "@solidjs/router";
 
-const getUsersQuery = query(async () => {
-	// ... Fetches users.
-}, "users");
+const getProjectTasks = query(async (projectId: string) => {
+	const response = await fetch(`/api/projects/${projectId}/tasks`);
+	return response.json() as Promise<{ id: string; title: string }[]>;
+}, "projectTasks");
 
-const getPostsQuery = query(async () => {
-	// ... Fetches posts.
-}, "posts");
+function ProjectTasks(props: { projectId: string }) {
+	const tasks = createAsync(() => getProjectTasks(props.projectId), {
+		initialValue: [],
+	});
 
-function refreshAll() {
-	revalidate([getUsersQuery.key, getPostsQuery.key]);
+	function refreshProjectTasks() {
+		void revalidate(getProjectTasks.keyFor(props.projectId));
+	}
+
+	return (
+		<>
+			<button onClick={refreshProjectTasks}>Refresh project tasks</button>
+			<div>{tasks().length} tasks</div>
+		</>
+	);
 }
 ```
 
 ## Related
 
 - [`query`](/solid-router/reference/data-apis/query)
 - [`createAsync`](/solid-router/reference/data-apis/create-async)
+- [`reload`](/solid-router/reference/response-helpers/reload)

src/routes/solid-router/reference/data-apis/use-action.mdx

@@ -1,23 +1,17 @@
 ---
 title: useAction
 use_cases: >-
-  programmatic forms, client-side mutations, imperative actions, non-form
-  submissions
+  actions, programmatic actions, mutations
 tags:
   - actions
   - mutations
-  - client
-  - imperative
   - programmatic
 version: "1.0"
 description: >-
-  Invoke actions programmatically without forms using useAction. Perfect for
-  client-side mutations and imperative updates.
+  useAction returns a router-bound action caller.
 ---
 
-The `useAction` primitive returns a function that triggers an [action](/solid-router/concepts/actions) when called.
-
-`useAction` requires client-side JavaScript and is not progressively enhanceable.
+`useAction` returns a function that calls an [`action`](/solid-router/reference/data-apis/action) with the current router context. It is the programmatic caller for non-form submissions.
 
 ## Import
 
@@ -40,25 +34,36 @@ function useAction<T extends Array<any>, U, V>(
 - **Type:** `Action<T, U, V>`
 - **Required:** Yes
 
-The action to be triggered.
+[`Action`](/solid-router/reference/data-apis/action) to bind to the current router.
 
 ## Return value
 
-`useAction` returns a function that triggers the action.
-It takes the same parameters as the action handler and returns a [`Promise`](https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise) that resolves with the action's result.
+- **Type:** `(...args: Parameters<Action<T, U, V>>) => Promise<NarrowResponse<U>>`
+
+Returns a router-bound caller with the same arguments as `action`.
+
+## Behavior
+
+- Unlike native form submissions, calls made with `useAction` depend on client-side JavaScript.
 
-## Example
+## Examples
+
+### Basic usage
 
 ```tsx
 import { action, useAction } from "@solidjs/router";
 
-const likePostAction = action(async (id: string) => {
-	// ... Likes a post on the server.
-});
+const likePost = action(async (id: string) => {
+	return id;
+}, "likePost");
 
-function LikeButton(props: { postId: string }) {
-	const likePost = useAction(likePostAction);
+function LikeButton(props: { id: string }) {
+	const like = useAction(likePost);
 
-	return <button onClick={() => likePost(props.postId)}>Like</button>;
+	return <button onClick={() => like(props.id)}>Like</button>;
 }
 ```
+
+## Related
+
+- [`action`](/solid-router/reference/data-apis/action)