diff --git a/develop-docs/sdk/expected-features/index.mdx b/develop-docs/sdk/expected-features/index.mdx index b15050d959162..9b88e052a951e 100644 --- a/develop-docs/sdk/expected-features/index.mdx +++ b/develop-docs/sdk/expected-features/index.mdx @@ -1,11 +1,13 @@ --- -title: Expected Features +title: Features +description: The following is a description of features that are commonly expected in Sentry SDKs. sidebar_order: 4 --- -The following is a description of features that are commonly expected in Sentry SDKs. Make sure to also -have read the unified API design documentation -which explains the common API design. + + Make sure to also have read the unified API documentation + which explains the common API design. + ## Background Sending diff --git a/develop-docs/sdk/index.mdx b/develop-docs/sdk/index.mdx index ca0e378a5761d..93b3d77e6e6a2 100644 --- a/develop-docs/sdk/index.mdx +++ b/develop-docs/sdk/index.mdx @@ -3,17 +3,4 @@ title: SDK Development sidebar_order: 60 --- -The following is a guide for implementing a Sentry SDK. - -It covers the protocol for event submission as well as guidelines for how clients should -typically look and behave. - -- Overview -- Philosophy and Design Principles -- Development Process -- Expected Features -- Telemetry -- Data Model -- Javascript SDKs -- Native SDKs -- Serverless SDKs + diff --git a/develop-docs/sdk/miscellaneous/index.mdx b/develop-docs/sdk/miscellaneous/index.mdx index ab3e7d57d45c7..8cee6e7fdfb6e 100644 --- a/develop-docs/sdk/miscellaneous/index.mdx +++ b/develop-docs/sdk/miscellaneous/index.mdx @@ -1,6 +1,6 @@ --- title: Miscellaneous -sidebar_order: 10 +sidebar_order: 100 --- diff --git a/develop-docs/sdk/overview.mdx b/develop-docs/sdk/overview.mdx index 6a1f1a8aff52d..e9c015acbf5b9 100644 --- a/develop-docs/sdk/overview.mdx +++ b/develop-docs/sdk/overview.mdx @@ -1,10 +1,9 @@ --- title: Overview +description: The following is a guide for implementing a new Sentry SDK. It covers the protocol for event submission as well as guidelines for how clients should typically look and behave. sidebar_order: 1 --- -The following is a guide for implementing a new Sentry SDK. It covers the protocol for event submission as well as guidelines for how clients should typically look and behave. - ## Writing an SDK At its core an SDK is a set of utilities for capturing data about an exceptional state in an application. Given this data, it then builds and sends a JSON payload to the Sentry server. diff --git a/develop-docs/sdk/philosophy.mdx b/develop-docs/sdk/philosophy.mdx index c5ea0f9c84471..598b1c62f2e28 100644 --- a/develop-docs/sdk/philosophy.mdx +++ b/develop-docs/sdk/philosophy.mdx @@ -1,9 +1,9 @@ --- title: Philosophy +description: This document sets some general guidance for how to approach SDK development at Sentry. It should aid both internal and external developers to understand what motivations go into the design of the SDKs and why we're deciding in certain ways. sidebar_order: 2 --- -This document sets some general guidance for how to approach SDK development at Sentry. It should aid both internal and external developers to understand what motivations go into the design of the SDKs and why we're deciding in certain ways. ## Trust is #1 diff --git a/develop-docs/sdk/development-process/basics.mdx b/develop-docs/sdk/processes/basics.mdx similarity index 81% rename from develop-docs/sdk/development-process/basics.mdx rename to develop-docs/sdk/processes/basics.mdx index 146afc45f4c47..8b2b60f5c1735 100644 --- a/develop-docs/sdk/development-process/basics.mdx +++ b/develop-docs/sdk/processes/basics.mdx @@ -1,12 +1,9 @@ --- title: Basics -description: How to get started with SDK development. +description: So you want to develop an SDK? Before you get started here are some basics that are worth following to have a better experience. sidebar_order: 1 --- -So you want to develop an SDK? Before you get started here are some basics that are -worth following to have a better experience. - ## Run a Local Relay You do not need a local Sentry for SDK development but you will want to run a local @@ -35,9 +32,9 @@ When sending events just substitute `orgXXX.ingest.sentry.io` with `localhost:30 whichever port you ended up chosing. Also note that a local relay will out of the box be available via HTTP only so don't try to send HTTPS requests there. -## Join the SDK chat on Discord +## Join us on Discord -You can reach out to Sentry open source contributors and talk with other SDK maintainers in the [Sentry Discord server](https://discord.gg/sentry). Make sure to say hi in the `#sdk-chat`. +You can reach out to Sentry open source contributors and talk with other SDK maintainers on the [Sentry Discord server](https://discord.gg/sentry). ## Consult Existing SDKs diff --git a/develop-docs/sdk/development-process/index.mdx b/develop-docs/sdk/processes/index.mdx similarity index 85% rename from develop-docs/sdk/development-process/index.mdx rename to develop-docs/sdk/processes/index.mdx index 940c33ea5d71a..d5ccd6814648b 100644 --- a/develop-docs/sdk/development-process/index.mdx +++ b/develop-docs/sdk/processes/index.mdx @@ -1,5 +1,5 @@ --- -title: Development Process +title: Processes description: In this section, we aim to highlight some key processes that are essential for SDK development at Sentry. sidebar_order: 3 --- diff --git a/develop-docs/sdk/development-process/releases.mdx b/develop-docs/sdk/processes/releases.mdx similarity index 100% rename from develop-docs/sdk/development-process/releases.mdx rename to develop-docs/sdk/processes/releases.mdx diff --git a/develop-docs/sdk/development-process/triaging.mdx b/develop-docs/sdk/processes/triaging.mdx similarity index 100% rename from develop-docs/sdk/development-process/triaging.mdx rename to develop-docs/sdk/processes/triaging.mdx diff --git a/src/components/docPage/type.scss b/src/components/docPage/type.scss index a6c5931c442cf..387a079287593 100644 --- a/src/components/docPage/type.scss +++ b/src/components/docPage/type.scss @@ -1,6 +1,10 @@ // dark mode .dark .prose { --heading-color: var(--gray-12); + + hgroup h2 { + color: var(--desatPurple12); + } } .prose { @@ -68,7 +72,7 @@ hgroup h2 { font-weight: 300; font-size: 1.3rem; - color: var(--foreground-secondary); + color: var(--desatPurple2); line-height: 2rem; margin-bottom: 1.75rem; }