diff --git a/develop-docs/ingestion/index.mdx b/develop-docs/ingestion/index.mdx
index 913223ff140ca..e3e602958dfaf 100644
--- a/develop-docs/ingestion/index.mdx
+++ b/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/).
+
diff --git a/develop-docs/ingestion/relay/index.mdx b/develop-docs/ingestion/relay/index.mdx
new file mode 100644
index 0000000000000..ff9f3cbbd4193
--- /dev/null
+++ b/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/).
diff --git a/develop-docs/ingestion/projectconfig-versioning.mdx b/develop-docs/ingestion/relay/projectconfig-versioning.mdx
similarity index 99%
rename from develop-docs/ingestion/projectconfig-versioning.mdx
rename to develop-docs/ingestion/relay/projectconfig-versioning.mdx
index b1ef6bfdcece8..3a27efdccd5d8 100644
--- a/develop-docs/ingestion/projectconfig-versioning.mdx
+++ b/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?
diff --git a/develop-docs/ingestion/relay-best-practices.mdx b/develop-docs/ingestion/relay/relay-best-practices.mdx
similarity index 99%
rename from develop-docs/ingestion/relay-best-practices.mdx
rename to develop-docs/ingestion/relay/relay-best-practices.mdx
index e66397485bb59..c701ac7ebb4df 100644
--- a/develop-docs/ingestion/relay-best-practices.mdx
+++ b/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.
diff --git a/develop-docs/ingestion/transaction-span-ratelimits.mdx b/develop-docs/ingestion/relay/transaction-span-ratelimits.mdx
similarity index 99%
rename from develop-docs/ingestion/transaction-span-ratelimits.mdx
rename to develop-docs/ingestion/relay/transaction-span-ratelimits.mdx
index e13c3e239fd55..ff1676bdaf3d7 100644
--- a/develop-docs/ingestion/transaction-span-ratelimits.mdx
+++ b/develop-docs/ingestion/relay/transaction-span-ratelimits.mdx
@@ -1,5 +1,6 @@
---
title: Transaction and Span Rate Limiting
+sidebar_order: 30
---
diff --git a/src/middleware.ts b/src/middleware.ts
index 26650e5f9d703..5f53f89908c13 100644
--- a/src/middleware.ts
+++ b/src/middleware.ts
@@ -3816,17 +3816,22 @@ const DEVELOPER_DOCS_REDIRECTS: Redirect[] = [
from: '/backend/ab-testing/',
to: '/api-server/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/',
},
];