diff --git a/src/docs/sdk/philosophy.mdx b/src/docs/sdk/philosophy.mdx index 206ec394b9..8711fcc011 100644 --- a/src/docs/sdk/philosophy.mdx +++ b/src/docs/sdk/philosophy.mdx @@ -57,3 +57,7 @@ Please check Data Handling for more detail. ## Don’t forget the big picture Being correct is important but even more important is doing the right thing. Yes, we are building libraries and with that comes much responsibility. But in the end, we build a product that should solve a problem users have in their application. This principle relates to many other things mentioned on this page - but most importantly, it should act as a reminder that we only succeed if we manage to solve a problem end-to-end. + +## 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.