Move revalidate docs to the Data APIs section (#1206)

Co-authored-by: kodiakhq[bot] <49736102+kodiakhq[bot]@users.noreply.github.com>

Author: amirhhashemi

src/middleware/legacy-routes-redirect.ts

@@ -107,7 +107,8 @@ const LEGACY_ROUTES = {
 
 	// solid-docs-next moves/new location for old pages/solid api updates
 	"/reference/jsx-attributes/on-and-oncapture": "/reference/jsx-attributes/on",
-
+	
+	"/solid-router/reference/response-helpers/revalidate": "/solid-router/reference/data-apis/revalidate",
 } as const;
 
 function isLegacyRoute(path: string): path is keyof typeof LEGACY_ROUTES {

src/routes/solid-router/reference/data-apis/data.json

@@ -6,6 +6,7 @@
 		"create-async.mdx",
 		"create-async-store.mdx",
 		"query.mdx",
+		"revalidate.mdx",
 		"use-action.mdx",
 		"use-submission.mdx",
 		"use-submissions.mdx"

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

@@ -0,0 +1,43 @@
+---
+title: revalidate
+---
+
+The `revalidate` function is used to revalidate queries associated with specified [query keys](/solid-router/reference/data-apis/query#query-keys).
+When a [query](/solid-router/reference/data-apis/query) is revalidated, it is executed again, and any references to the associated query data are updated accordingly.
+
+```tsx
+import { For } from "solid-js";
+import { query, createAsync, revalidate } from "@solidjs/router";
+
+const getPosts = query(async () => {
+	return await fetch("https://api.com/posts").then((response) =>
+		response.json()
+	);
+}, "posts");
+
+function Posts() {
+	const posts = createAsync(() => getPosts());
+
+	function refetchPosts() {
+		revalidate(getPosts.key);
+	}
+
+	return (
+		<div>
+			<button onClick={refetchPosts}>Refetch posts</button>
+			<ul>
+				<For each={posts()}>{(post) => <li>{post.title}</li>}</For>
+			</ul>
+		</div>
+	);
+}
+```
+
+## Parameters
+
+- `key`: The query key or an array of query keys to be revalidated.
+- `force` (optional): A boolean that indicates whether to delete the existing cached value of the queries.
+  Note that this cache is solely for de-duplication purposes.
+  Therefore, deleting the cache only affects de-duplication.
+  For more information on how `query` works, refer to [the `query` documentation](/solid-router/reference/data-apis/query).
+  The default value is `true`.

src/routes/solid-router/reference/response-helpers/data.json

@@ -1,4 +1,4 @@
 {
 	"title": "Response helpers",
-	"pages": ["json.mdx", "redirect.mdx", "reload.mdx", "revalidate.mdx"]
+	"pages": ["json.mdx", "redirect.mdx", "reload.mdx"]
 }