diff --git a/develop-docs/api-server/index.mdx b/develop-docs/api-server/index.mdx index a7533a14c51993..ad020c1a0c77f5 100644 --- 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 heart of Sentry. The backend of our application. sidebar_order: 50 --- -The monolith powering Sentry. The backend of our application. - diff --git a/develop-docs/application-architecture/index.mdx b/develop-docs/application-architecture/index.mdx index faf2dd2eb6a5a6..000190dd91549c 100644 --- 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 index e8bd87961860e3..5c9fec67697d97 100644 --- 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 index 8cc6a04eb1656b..e75c58e34d34e7 100644 --- 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 index a168bbe942dcce..fcaa10cf2172c8 100644 --- 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 focuses on the frontend part of 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 index 65de1b40e2f0c3..913223ff140caa 100644 --- 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 index 6dc434f2599e28..df85290137c625 100644 --- 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 index 7e7340b5744443..b45ca7e757df36 100644 --- 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 index ef831da50893bf..428b379a391c02 100644 --- 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 index 1b64b474d219a5..1ae2aa8f7e1cce 100644 --- 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. -