Added awarness section to top level pages

getsentry · Dec 12, 2024 · e6dc5bf · e6dc5bf
1 parent 71f3501
commit e6dc5bf
Show file tree

Hide file tree

Showing 10 changed files with 13 additions and 7 deletions.
diff --git a/develop-docs/api-server/index.mdx b/develop-docs/api-server/index.mdx
@@ -1,8 +1,7 @@
 ---
 title: API Server
+description: Documentation of the monolith, the hearth of Sentry. The backend of our application.
 sidebar_order: 50
 ---
 
-The monolith powering Sentry. The backend of our application.
-
 <PageGrid />
diff --git a/develop-docs/application-architecture/index.mdx b/develop-docs/application-architecture/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Application Architecture
+description: Documentation of the system architecture, all the moving parts of this big distributed system we call Sentry.
 sidebar_order: 30
 ---
 

diff --git a/develop-docs/development-infrastructure/index.mdx b/develop-docs/development-infrastructure/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Development Infrastructure
+description: How to get your local development environment up and running.
 sidebar_order: 40
 ---
 

diff --git a/develop-docs/engineering-practices/index.mdx b/develop-docs/engineering-practices/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Engineering Practices
+description: Our take on software engineering. Some practices that all engineers working on Sentry should follow.
 sidebar_order: 20
 ---
 

diff --git a/develop-docs/frontend/index.mdx b/develop-docs/frontend/index.mdx
@@ -1,9 +1,10 @@
 ---
-title: Frontend Handbook
+title: Frontend
+description: How we write frontend code at Sentry.
 sidebar_order: 60
 ---
 
-This guide covers how we write frontend code at Sentry, and is specifically focussed on the [Sentry](https://github.com/getsentry/sentry) and [Getsentry](https://github.com/getsentry/getsentry) codebases. It assumes you are using the eslint rules outlined by [eslint-config-sentry](https://github.com/getsentry/eslint-config-sentry); hence code style enforced by these linting rules will not be discussed here.
+This guide specifically focussed on the [Sentry](https://github.com/getsentry/sentry) and [Getsentry](https://github.com/getsentry/getsentry) codebases. It assumes you are using the eslint rules outlined by [eslint-config-sentry](https://github.com/getsentry/eslint-config-sentry); hence code style enforced by these linting rules will not be discussed here.
 
 ## Directory structure
 

diff --git a/develop-docs/ingestion/index.mdx b/develop-docs/ingestion/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Ingestion
+description: How Sentry receives and processes data before putting it into storage.
 sidebar_order: 90
 ---
 

diff --git a/develop-docs/integrations/index.mdx b/develop-docs/integrations/index.mdx
@@ -1,5 +1,6 @@
 ---
-title: Developing Integrations
+title: Integrations
+description: How to setup Sentry integrations. Integrations connect the Sentry server with other services.
 sidebar_order: 80
 ---
 

diff --git a/develop-docs/sdk/index.mdx b/develop-docs/sdk/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: SDK Development
+description: The software running in our users projects that are responsible for collecting data.
 sidebar_order: 100
 ---
 

diff --git a/develop-docs/self-hosted/index.mdx b/develop-docs/self-hosted/index.mdx
@@ -1,5 +1,6 @@
 ---
 title: Self-Hosted Sentry
+description: How you can run all of Sentry on your own server, without paying anything.
 sidebar_order: 110
 ---
 

diff --git a/develop-docs/services/index.mdx b/develop-docs/services/index.mdx
@@ -1,8 +1,7 @@
 ---
 title: Services
+description: Services we operate that exist outside of the API Server monolith.
 sidebar_order: 70
 ---
 
-Services we operate that exist outside of the API Server monolith.
-
 <PageGrid />