From 9fb4658048a0db92d6e2710a4fe0446c93b1e8ca Mon Sep 17 00:00:00 2001 From: Daniel Griesser Date: Thu, 17 Oct 2024 06:29:23 +0200 Subject: [PATCH 1/2] feat: Add Trust is _1 --- develop-docs/sdk/philosophy.mdx | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/develop-docs/sdk/philosophy.mdx b/develop-docs/sdk/philosophy.mdx index 86f6ab37e7b9d..635235cbb360b 100644 --- a/develop-docs/sdk/philosophy.mdx +++ b/develop-docs/sdk/philosophy.mdx @@ -61,3 +61,7 @@ Being correct is important but even more important is doing the right thing. Yes ## Write less code The role of an SDK is to instrument the user's application, collect context around the event types we want to capture, and send event data with useful context to Sentry. We should avoid extensive business logic within the SDK that transforms this data as it can get complex, hard to maintain and makes permanent changes to the wire format we send events. We should aim to have data collected by the SDK be as raw as possible. We have more flexibility and control on the server to manipulate the data more effectively. + +## Trust is #1 + +Sentry’s mission is to “Enable developers to ship with confidence” and their journey always starts with our SDKs. Above everything else, we need to make sure that our customers can rely on the stability of our SDKs because they depend on them. We are committed to having the most stable SDKs on the market and will own up to our mistakes with transparency and clarity. \ No newline at end of file From 367480275749fa5bf8e8d9712f2a764b9bd3536e Mon Sep 17 00:00:00 2001 From: Daniel Griesser Date: Wed, 23 Oct 2024 11:50:01 +0200 Subject: [PATCH 2/2] Move to first position --- develop-docs/sdk/philosophy.mdx | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) diff --git a/develop-docs/sdk/philosophy.mdx b/develop-docs/sdk/philosophy.mdx index 635235cbb360b..c5ea0f9c84471 100644 --- a/develop-docs/sdk/philosophy.mdx +++ b/develop-docs/sdk/philosophy.mdx @@ -5,6 +5,10 @@ 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 + +Sentry’s mission is to “Enable developers to ship with confidence” and their journey always starts with our SDKs. Above everything else, we need to make sure that our customers can rely on the stability of our SDKs because they depend on them. We are committed to having the most stable SDKs on the market and will own up to our mistakes with transparency and clarity. + ## Dependencies Cost Dependencies come with a cost and that cost is high. Every dependency we use increases the surface area of the SDK and add more licensing, maintenance and security concerns. We understand that dependencies are necessary for supporting integrations, but dependencies must never be required for the base line functionality of an SDK. Obviously every rule also has exceptions and on some platforms we won't be able to work without a base level of dependencies. A good example is Python where we require an external library for HTTP requests to safely send HTTP requests. @@ -61,7 +65,3 @@ Being correct is important but even more important is doing the right thing. Yes ## Write less code The role of an SDK is to instrument the user's application, collect context around the event types we want to capture, and send event data with useful context to Sentry. We should avoid extensive business logic within the SDK that transforms this data as it can get complex, hard to maintain and makes permanent changes to the wire format we send events. We should aim to have data collected by the SDK be as raw as possible. We have more flexibility and control on the server to manipulate the data more effectively. - -## Trust is #1 - -Sentry’s mission is to “Enable developers to ship with confidence” and their journey always starts with our SDKs. Above everything else, we need to make sure that our customers can rely on the stability of our SDKs because they depend on them. We are committed to having the most stable SDKs on the market and will own up to our mistakes with transparency and clarity. \ No newline at end of file