Memgql docs redesign

.gitignore

@@ -12,3 +12,7 @@ pnpm-lock.yaml
 .claude/
 CLAUDE.md
 .release-tracking/
+
+# MemGQL docs redesign — local verification scratchpad (do not commit)
+UNVERIFIED-CLAIMS.local.md
+PROPOSAL.md

next.config.mjs

@@ -19,6 +19,57 @@ export default withNextra({
   reactStrictMode: true,
   async redirects() {
     return [
+      // MemGQL docs restructure (Idea-B sections)
+      {
+        source: '/memgraph-zero/memgql/quick-start',
+        destination: '/memgraph-zero/memgql/get-started/quick-start',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/complete',
+        destination: '/memgraph-zero/memgql/get-started/docker-compose',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/use-cases',
+        destination: '/memgraph-zero/memgql/overview/use-cases',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/use-cases/:path*',
+        destination: '/memgraph-zero/memgql/overview/use-cases/:path*',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/features',
+        destination: '/memgraph-zero/memgql/overview/editions',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/connect',
+        destination: '/memgraph-zero/memgql/connectors',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/connect/:path*',
+        destination: '/memgraph-zero/memgql/connectors/:path*',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/multiple-graphs',
+        destination: '/memgraph-zero/memgql/guides/querying-across-backends',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/licensing',
+        destination: '/memgraph-zero/memgql/reference/licensing',
+        permanent: true
+      },
+      {
+        source: '/memgraph-zero/memgql/changelog',
+        destination: '/memgraph-zero/memgql/reference/changelog',
+        permanent: true
+      },
       {
         source: '/cypher-manual/graph-algorithms',
         destination: '/advanced-algorithms',

pages/memgraph-zero.mdx

@@ -46,24 +46,24 @@ releases.
 Memgraph Zero solves specific problems that teams face when data is scattered
 across systems and compliance boundaries:
 
-- **[Public-Private Data](/memgraph-zero/memgql/use-cases/public-private)** —
+- **[Public-Private Data](/memgraph-zero/memgql/overview/use-cases/public-private)** —
   Keep sensitive data sovereign while querying it alongside public knowledge
   graphs. Private customer records stay in PostgreSQL; public catalogs live in
   Memgraph. One GQL query joins both without moving regulated data.
 
-- **[Enterprise Context Sharing](/memgraph-zero/memgql/use-cases/enterprise-context)** —
+- **[Enterprise Context Sharing](/memgraph-zero/memgql/overview/use-cases/enterprise-context)** —
   Share canonical context across departments without forcing every team into the
   same database.
 
-- **[Distributed Compute](/memgraph-zero/memgql/use-cases/distributed)** —
+- **[Distributed Compute](/memgraph-zero/memgql/overview/use-cases/distributed)** —
   Spread graph computation across multiple nodes for workloads that exceed a
   single instance.
 
-- **[Agentic Data Access](/memgraph-zero/memgql/use-cases/agentic)** —
+- **[Agentic Data Access](/memgraph-zero/memgql/overview/use-cases/agentic)** —
   Give AI agents a single semantic layer to discover and query any data in the
   organization using standard GQL.
 
-See all [use cases](/memgraph-zero/memgql/use-cases) for working examples and
+See all [use cases](/memgraph-zero/memgql/overview/use-cases) for working examples and
 Docker Compose setups you can run yourself.
 
 ## Why Zero ETL matters

pages/memgraph-zero/memgql.mdx

@@ -18,22 +18,19 @@ Bolt-compatible driver.
 
 The long-term vision for MemGQL is to cover all data source types — structured,
 semi-structured and unstructured — essentially serving as a semantic layer
-where agents can find any data behind a single interface.
+where agents can find any data behind a single interface. It is the first
+component of [Memgraph Zero](/memgraph-zero), Memgraph's "connect, don't
+collect" product line.
 
 ![MemGQL Reference Architecture](/pages/memgraph-zero/memgql/memgql_ref_architecture.png)
 
-New to MemGQL? Start with the [Quick Start](/memgraph-zero/memgql/quick-start) guide
-to get up and running in minutes. Once you're set up, check out the
-[Use Cases](/memgraph-zero/memgql/use-cases) to see real-world applications, and
-explore the [Features](/memgraph-zero/memgql/features) to understand what MemGQL can
-do. Learn how to [Connect](/memgraph-zero/memgql/connect) to your data sources and
-review the [Multiple Graphs](/memgraph-zero/memgql/multiple-graphs) support for
-querying across heterogeneous backends. For local development, check out the [Docker
-Compose](/memgraph-zero/memgql/complete) setup. When you're ready to dive deeper, the
-[Reference](/memgraph-zero/memgql/reference) documentation covers all the syntax
-details. Review the [Licensing](/memgraph-zero/memgql/licensing) information for terms
-of use, and check the [Changelog](/memgraph-zero/memgql/changelog) to stay updated on
-the latest improvements.
+## Start here
+
+- **[Quick Start](/memgraph-zero/memgql/get-started/quick-start)** — run MemGQL against Memgraph in minutes.
+- **[How it works](/memgraph-zero/memgql/overview/how-it-works)** — the architecture: translation, mappings, connectors, and routing.
+- **[Connectors](/memgraph-zero/memgql/connectors)** — every supported backend and exactly which GQL features each one supports.
+- **[Querying across backends](/memgraph-zero/memgql/guides/querying-across-backends)** — federate queries over multiple backends, with or without `USE`.
+- **[Reference](/memgraph-zero/memgql/reference)** — the full GQL feature support, statements, and configuration.
 
 ## Questions & Feedback
 

pages/memgraph-zero/memgql/_meta.ts

@@ -1,11 +1,7 @@
 export default {
-  "quick-start": "Quick Start",
-  "use-cases": "Use Cases",
-  "features": "Features",
-  "connect": "Connect",
-  "multiple-graphs": "Multiple Graphs",
-  "complete": "Docker Compose",
+  "overview": "Overview",
+  "get-started": "Get started",
+  "connectors": "Connectors",
+  "guides": "Guides",
   "reference": "Reference",
-  "licensing": "Licensing",
-  "changelog": "Changelog",
 }