[Develop] Add dedicated relay section (#12143)

Author: antonpirker

develop-docs/ingestion/index.mdx

@@ -4,11 +4,6 @@ description: How Sentry receives and processes data before putting it into stora
 sidebar_order: 90
 ---
 
-Ingestion is done by [Sentry Relay](https://github.com/getsentry/relay), a service for event filtering, rate-limiting, and processing.
+Sentry can process and store millions of events per second. Here is the documentation of the tools used in Sentry's processing and ingestion pipeline.
 
-It can act as:
-
-* the store endpoint for your Sentry installation. See [Relay developer
-  documentation](https://getsentry.github.io/relay/relay/).
-* an additional middle layer between your application and Sentry. See [Relay product
-  documentation](https://docs.sentry.io/product/relay/).
+<PageGrid />

develop-docs/ingestion/relay/index.mdx

@@ -0,0 +1,13 @@
+---
+title: Relay
+description: A service for filtering, rate-limiting, and processing vast amounts of Sentry events.
+---
+
+Ingestion is done by [Sentry Relay](https://github.com/getsentry/relay), a service for event filtering, rate-limiting, and processing.
+
+It can act as:
+
+* the store endpoint for your Sentry installation. See [Relay developer
+  documentation](https://getsentry.github.io/relay/relay/).
+* an additional middle layer between your application and Sentry. See [Relay product
+  documentation](https://docs.sentry.io/product/relay/).

develop-docs/ingestion/projectconfig-versioning.mdx renamed to develop-docs/ingestion/relay/projectconfig-versioning.mdx

@@ -1,5 +1,6 @@
 ---
 title: Naming and versioning patterns in project config
+sidebar_order: 20
 ---
 
 ## Internal vs External Relay?

develop-docs/ingestion/relay-best-practices.mdx renamed to develop-docs/ingestion/relay/relay-best-practices.mdx

@@ -1,5 +1,6 @@
 ---
 title: Relay Best Practices
+sidebar_order: 10
 ---
 
 Relay is a critical component in Sentry's infrastructure handling hundreds of thousands of requests per second.

develop-docs/ingestion/transaction-span-ratelimits.mdx renamed to develop-docs/ingestion/relay/transaction-span-ratelimits.mdx

@@ -1,5 +1,6 @@
 ---
 title: Transaction and Span Rate Limiting
+sidebar_order: 30
 ---
 
 <Alert level="warning" title="Important">

src/middleware.ts

@@ -3912,17 +3912,22 @@ const DEVELOPER_DOCS_REDIRECTS: Redirect[] = [
     from: '/api-server/application-domains/ab-testing/',
     to: '/develop/application-domains/ab-testing/',
   },
+  /* Ingestion section rework */
   {
     from: '/relay/',
-    to: '/ingestion/',
+    to: '/ingestion/relay/',
   },
   {
     from: '/relay/projectconfig-versioning/',
-    to: '/ingestion/projectconfig-versioning/',
+    to: '/ingestion/relay/projectconfig-versioning/',
   },
   {
     from: '/relay/transaction-span-ratelimits/',
-    to: '/ingestion/transaction-span-ratelimits/',
+    to: '/ingestion/relay/transaction-span-ratelimits/',
+  },
+  {
+    from: '/relay/relay-best-practices/',
+    to: '/ingestion/relay/relay-best-practices/',
   },
 ];