DX-1894: search docs init

mint.json

@@ -57,6 +57,10 @@
       "name": "Workflow",
       "url": "workflow"
     },
+    {
+      "name": "Search",
+      "url": "search"
+    },
     {
       "name": "Developer API",
       "url": "devops"
@@ -1377,6 +1381,81 @@
         "workflow/roadmap",
         "workflow/llms-txt"
       ]
+    },
+    {
+      "group": "",
+      "pages": [
+        {
+          "group": "Overall",
+          "pages": [
+            "search/overall/getstarted",
+            "search/overall/whatisupstashsearch",
+            "search/overall/pricing"
+          ]
+        },
+        {
+          "group": "Features",
+          "pages": [
+            "search/features/algorithm",
+            "search/features/indexes",
+            "search/features/content-and-metadata",
+            "search/features/filtering",
+            "search/features/reranking"
+          ]
+        },
+        {
+          "group": "SDKs",
+          "pages": [
+            {
+              "group": "Typescript",
+              "pages": [
+                "search/sdks/ts/getting-started",
+                "search/sdks/ts/contributing",
+                {
+                  "group": "Commands",
+                  "pages": [
+                    "search/sdks/ts/commands/search",
+                    "search/sdks/ts/commands/upsert",
+                    "search/sdks/ts/commands/fetch",
+                    "search/sdks/ts/commands/delete",
+                    "search/sdks/ts/commands/range",
+                    "search/sdks/ts/commands/reset",
+                    "search/sdks/ts/commands/info"
+                  ]
+                }
+              ]
+            },
+            {
+              "group": "Python",
+              "pages": [
+                "search/sdks/py/gettingstarted",
+                {
+                  "group": "Commands",
+                  "pages": [
+                    "search/sdks/py/commands/search",
+                    "search/sdks/py/commands/upsert",
+                    "search/sdks/py/commands/fetch",
+                    "search/sdks/py/commands/delete",
+                    "search/sdks/py/commands/range",
+                    "search/sdks/py/commands/reset",
+                    "search/sdks/py/commands/info"
+                  ]
+                }
+              ]
+            }
+          ]
+        },
+        {
+          "group": "Quickstarts",
+          "pages": [
+            "search/tutorials/nextjs"
+          ]
+        },
+        {
+          "group": "Help",
+          "pages": ["search/help/faq"]
+        }
+      ]
     }
   ],
   "api": {

search/.keep

@@ -0,0 +1 @@
+// This file ensures the search directory is tracked by version control. 

search/features/algorithm.mdx

@@ -0,0 +1,19 @@
+---
+title: Algorithm
+---
+
+Upstash Search blends semantic search with traditional exact keyword matching
+to deliver results that are both accurate and relevant. By combining these
+two approaches, it captures what users mean, not just what they type,
+while still making sure exact keyword hits aren’t missed.
+
+The system uses a hybrid setup that supports flexible “OR” logic for full-text search,
+which pairs nicely with the semantic side. Together, they let Upstash Search:
+
+- Understand the intent behind a query, even if the wording isn’t exact
+- Find documents with related or alternative phrasing
+- Work across all kinds of content and domains
+
+Behind the scenes, user queries get a subtle boost from large language models,
+helping the system better understand context and return smarter results
+even when queries are vague or incomplete.

search/features/content-and-metadata.mdx

@@ -0,0 +1,83 @@
+---
+title: Content and Metadata
+---
+
+## Content
+
+Content is the indexed component of documents. It is a json
+object which is indexed and can also be [filtered](/search/features/filtering).
+
+It is mandatory to provide the content while upserting documents.
+
+<Tabs>
+
+<Tab title="Python">
+```py
+index.upsert(
+  documents=[
+    {
+      "id": "star-wars",
+      "content": { "text": "Star Wars is a sci-fi space opera."}
+    }
+  ]
+)
+```
+</Tab>
+
+<Tab title="TypeScript">
+```ts
+await index.upsert([
+  {
+    id: "star-wars",
+    content: { title: "Star Wars", genre: "sci-fi", category: "classic" }
+  }
+]);
+```
+</Tab>
+
+</Tabs>
+
+## Metadata
+
+Metadata allow you to attach more context to your documents.
+It is an optional JSON structured object, which does not
+get indexed with the documents.
+
+It has two main use cases:
+
+1. As additional context for your application logic
+2. As filtering input for search queries
+
+You can upsert metadata with your documents as follows:
+
+<Tabs>
+
+<Tab title="Python">
+```py
+index.upsert(
+  documents=[
+    {
+      "id": "star-wars",
+      "content": { "text": "Star Wars is a sci-fi space opera."},
+      "metadata": {
+        "genre": "sci-fi",
+      }
+    }
+  ]
+)
+```
+</Tab>
+
+<Tab title="TypeScript">
+```ts
+await index.upsert([
+  {
+    id: "star-wars",
+    content: { title: "Star Wars", genre: "sci-fi", category: "classic" },
+    metadata: { director: "George Lucas" } ,
+  }
+]);
+```
+</Tab>
+
+</Tabs>