docs: simplify hive doc navigation and clarify offerings (#7047)

Author: jdolle

packages/web/docs/next.config.js

@@ -52,12 +52,17 @@ export default withGuildDocs({
     },
     {
       source: '/docs/features/registry-usage',
-      destination: '/docs/high-availability-cdn',
+      destination: '/docs/schema-registry/high-availability-cdn',
       permanent: true,
     },
     {
       source: '/docs/features/high-availability-cdn',
-      destination: '/docs/high-availability-cdn',
+      destination: '/docs/schema-registry/high-availability-cdn',
+      permanent: true,
+    },
+    {
+      source: '/docs/high-availability-cdn',
+      destination: '/docs/schema-registry/high-availability-cdn',
       permanent: true,
     },
     {
@@ -102,7 +107,7 @@ export default withGuildDocs({
     },
     {
       source: '/docs/self-hosting/apollo-federation-2',
-      destination: '/docs/self-hosting/external-composition',
+      destination: '/docs/schema-registry/self-hosting/external-composition',
       permanent: true,
     },
     {
@@ -121,8 +126,8 @@ export default withGuildDocs({
       permanent: true,
     },
     {
-      source: '/docs/features/laboratory',
-      destination: '/docs/dashboard/laboratory',
+      source: '/docs/features/laboratory/:path*',
+      destination: '/docs/schema-registry/laboratory/:path*',
       permanent: true,
     },
     {
@@ -145,10 +150,35 @@ export default withGuildDocs({
       destination: '/docs/use-cases/apollo-graphos',
       permanent: true,
     },
+    {
+      source: '/docs/specs/link-specifications',
+      destination: '/docs/api-reference/link-specifications',
+      permanent: true,
+    },
+    {
+      source: '/docs/graphql-api/:path*',
+      destination: '/docs/api-reference/graphql-api/:path*',
+      permanent: true,
+    },
+    {
+      source: '/docs/specs/usage-reports',
+      destination: '/docs/api-reference/usage-reports',
+      permanent: true,
+    },
+    {
+      source: '/docs/get-started/:path*',
+      destination: '/docs/schema-registry/get-started/:path*',
+      permanent: true,
+    },
+    {
+      source: '/docs/management/:path*',
+      destination: '/docs/schema-registry/management/:path*',
+      permanent: true,
+    },
     {
       // SEO: Redirect to the new URL
       source: '/docs/self-hosting/federation-2',
-      destination: '/docs/self-hosting/external-composition',
+      destination: '/docs/schema-registry/self-hosting/external-composition',
       permanent: true,
     },
     {
@@ -169,12 +199,27 @@ export default withGuildDocs({
     },
     {
       source: '/docs/self-hosting',
-      destination: '/docs/self-hosting/get-started',
+      destination: '/docs/schema-registry/self-hosting/get-started',
       permanent: true,
     },
     {
       source: '/docs/dashboard',
-      destination: '/docs/dashboard/insights',
+      destination: '/docs/schema-registry/usage-reporting',
+      permanent: true,
+    },
+    {
+      source: '/docs/dashboard/insights',
+      destination: '/docs/schema-registry/usage-reporting',
+      permanent: true,
+    },
+    {
+      source: '/docs/dashboard/explorer',
+      destination: '/docs/schema-registry/explorer',
+      permanent: true,
+    },
+    {
+      source: '/docs/dashboard/laboratory/:path*',
+      destination: '/docs/schema-registry/laboratory/:path*',
       permanent: true,
     },
     {
@@ -247,6 +292,11 @@ export default withGuildDocs({
       destination: '/docs/gateway/other-features/performance/deduplicate-inflight-requests',
       permanent: true,
     },
+    {
+      source: '/docs/self-hosting/:path*',
+      destination: '/docs/schema-registry/self-hosting/:path*',
+      permanent: true,
+    },
   ],
   env: {
     SITE_URL: 'https://the-guild.dev/graphql/hive',

packages/web/docs/public/docs/pages/features/monitoring-view.png

@@ -33,8 +33,8 @@ you missed it, we recently
 
 It is important to be aware of how a GraphQL API is used and what is the experience of its final
 users. To answer these questions GraphQL Hive collects
-[Usage Reports](https://the-guild.dev/graphql/hive/docs/specs/usage-reports). By looking at the
-sample below, you can get an idea of how GraphQL Hive knows when it's safe to delete a type or a
+[Usage Reports](https://the-guild.dev/graphql/hive/docs/api-reference/usage-reports). By looking at
+the sample below, you can get an idea of how GraphQL Hive knows when it's safe to delete a type or a
 field of your GraphQL API. This is the most important building block of all data available in
 GraphQL Hive.
 

packages/web/docs/public/docs/pages/specs/link-specifications/explorer_metadata-filter.png renamed to packages/web/docs/public/docs/pages/schema-registry/link-specifications/explorer_metadata-filter.png

@@ -31,8 +31,8 @@ the following GitHub issue for updates:
 [Hive Usage Reporting](https://github.com/the-guild-org/conductor/issues/369)
 
 **Other Gateway/SDK users**: We updated the
-[API specification for usage reporting](/docs/specs/usage-reports). Please adjust your custom
-implementation accordingly to report the usage of GraphQL Subscription operations.
+[API specification for usage reporting](/docs/api-reference/usage-reports). Please adjust your
+custom implementation accordingly to report the usage of GraphQL Subscription operations.
 
 **Additional Note:** We are currently only collecting the usage of GraphQL Subscription operations.
 We are now evaluating what additional metrics might be relevant for the Subscription analytics. If

packages/web/docs/public/docs/pages/specs/link-specifications/explorer_metadata-view.png renamed to packages/web/docs/public/docs/pages/schema-registry/link-specifications/explorer_metadata-view.png

@@ -14,7 +14,8 @@ GraphQL request is made. They're especially useful for handling authentication f
 where you may need to claim or refresh an access token, validate credentials, or set up custom
 headers - all before the request is sent.
 
-![Demo of Preflight Scripts](private-next-content-dir/dashboard/laboratory/editing.png)
+![Demo of Preflight Scripts](private-next-content-dir/schema-registry/laboratory/editing.png)
 
-Check out [the documentation on Preflight Scripts](/docs/dashboard/laboratory/preflight-scripts) for
+Check out
+[the documentation on Preflight Scripts](/docs/schema-registry/laboratory/preflight-scripts) for
 information on how to configure, edit, and use them.

packages/web/docs/src/app/blog/(posts)/graphql-hive-and-clickhouse/page.mdx

@@ -63,4 +63,4 @@ Hive continues to expand.
 
 ---
 
-[Learn more in the updated documentation](/docs/specs/link-specifications)
+[Learn more in the updated documentation](/docs/schema-registry/link-specifications)

packages/web/docs/src/app/product-updates/(posts)/2024-03-26-subscription-defer-stream-usage-reporting/page.mdx

@@ -1,17 +1,10 @@
 export default {
   index: 'Introduction',
-  'get-started': 'Get Started',
-  'schema-registry': 'Schema Registry',
-  'high-availability-cdn': 'High-Availability CDN',
-  dashboard: 'Dashboard',
+  'schema-registry': 'Console',
   gateway: 'Gateway',
   logger: 'Logger',
-  management: 'Management',
   'other-integrations': 'Other Integrations',
   'api-reference': 'CLI/API Reference',
-  specs: 'Specifications',
-  'graphql-api': 'GraphQL API',
   'use-cases': 'Use Cases',
   'migration-guides': 'Migration Guides',
-  'self-hosting': 'Self-Hosting',
 };

packages/web/docs/src/app/product-updates/(posts)/2024-12-27-preflight-script/page.mdx

@@ -1,6 +1,9 @@
 export default {
+  'graphql-api': 'Public GraphQL API',
   cli: 'Hive CLI',
-  'gateway-config': 'Hive Gateway Configuration',
+  client: 'Hive Client Configuration',
   'gateway-cli': 'Hive Gateway CLI',
-  client: 'Hive Client',
+  'gateway-config': 'Hive Gateway Configuration',
+  'link-specifications': 'Hive GraphQL Link Spec',
+  'usage-reports': 'Usage Report Spec',
 };