From 73c1b01abb0cd0daf92b5e522d9bb33a7c55bd4a Mon Sep 17 00:00:00 2001
From: Michael Hoffmann <michael.hoffmann@sentry.io>
Date: Mon, 9 Jan 2023 17:26:40 +0100
Subject: [PATCH 1/2] Update filtering docs

---
 .../common/configuration/filtering.mdx        | 22 ++++++++++++-------
 .../common/configuration/options.mdx          |  2 +-
 2 files changed, 15 insertions(+), 9 deletions(-)

diff --git a/src/platforms/common/configuration/filtering.mdx b/src/platforms/common/configuration/filtering.mdx
index eb1486215c761..d3650661f80f0 100644
--- a/src/platforms/common/configuration/filtering.mdx
+++ b/src/platforms/common/configuration/filtering.mdx
@@ -22,12 +22,6 @@ All Sentry SDKs support the <PlatformIdentifier name="before-send" /> callback m
 
 <PlatformContent includePath="configuration/before-send" />
 
-<PlatformSection supported={["javascript", "node"]}>
-
-<PlatformContent includePath="configuration/before-send-transaction" />
-
-</PlatformSection>
-
 Note also that breadcrumbs can be filtered, as discussed in [our Breadcrumbs documentation](/product/error-monitoring/breadcrumbs/).
 
 <PlatformSection notSupported={["apple", "dotnet", "elixir", "rust"]}>
@@ -91,9 +85,11 @@ In this example, the fingerprint is forced to a common value if an exception of
 
 <PlatformSection supported={["node", "javascript", "python", "php", "dotnet", "java", "ruby", "go", "react-native", "android", "dart"]} notSupported={["javascript.cordova"]}>
 
-## Using Sampling to Filter Transaction Events
+## Filtering Transaction Events
+
+To prevent certain transactions from being reported to Sentry, use the <PlatformIdentifier name="traces-sampler" /> or <PlatformIdentifier name="before-send-transaction" /> configuration option, which allows you to provide a function to evaluate the current transaction and drop it if it's not one you want.
 
-To prevent certain transactions from being reported to Sentry, use the <PlatformIdentifier name="traces-sampler" /> configuration option, which allows you to provide a function to evaluate the current transaction and drop it if it's not one you want. (It also allows you to sample different transactions at different rates.)
+### Using <PlatformIdentifier name="traces-sampler" />
 
 **Note:** The <PlatformIdentifier name="traces-sampler" /> and <PlatformIdentifier name="traces-sample-rate" /> config options are mutually exclusive. If you define a <PlatformIdentifier name="traces-sampler" /> to filter out certain transactions, you must also handle the case of non-filtered transactions by returning the rate at which you'd like them sampled.
 
@@ -101,6 +97,16 @@ In its simplest form, used just for filtering the transaction, it looks like thi
 
 <PlatformContent includePath="performance/traces-sampler-as-filter" />
 
+It also allows you to sample different transactions at different rates.
+
 Learn more about <PlatformLink to="/configuration/sampling/">configuring the sample rate</PlatformLink>.
 
+<PlatformSection supported={["node", "javascript", "php"]} notSupported={["php.symfony"]}>
+
+### Using <PlatformIdentifier name="before-transaction" />
+
+<PlatformContent includePath="configuration/before-send-transaction" />
+
+</PlatformSection>
+
 </PlatformSection>
diff --git a/src/platforms/common/configuration/options.mdx b/src/platforms/common/configuration/options.mdx
index fd6048a8f5ee4..f73c334049000 100644
--- a/src/platforms/common/configuration/options.mdx
+++ b/src/platforms/common/configuration/options.mdx
@@ -566,7 +566,7 @@ This function is called with an SDK-specific message or error event object, and
 
 </ConfigKey>
 
-<ConfigKey name="before-send-transaction" supported={["javascript", "node", "php"]}>
+<ConfigKey name="before-send-transaction" supported={["javascript", "node", "php"]} notSupported={["php.symfony"]}>
 
 This function is called with an SDK-specific transaction event object, and can return a modified transaction event object, or `null` to skip reporting the event. One way this might be used is for manual PII stripping before sending.
 

From ca4ccab0ea46c05efdec976e1f494eaf91533471 Mon Sep 17 00:00:00 2001
From: Michi Hoffmann <cleptric@users.noreply.github.com>
Date: Tue, 10 Jan 2023 10:28:44 +0100
Subject: [PATCH 2/2] Update src/platforms/common/configuration/filtering.mdx

Co-authored-by: Alexander Dinauer <adinauer@users.noreply.github.com>
---
 src/platforms/common/configuration/filtering.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/src/platforms/common/configuration/filtering.mdx b/src/platforms/common/configuration/filtering.mdx
index d3650661f80f0..ed7e0cb1e91ce 100644
--- a/src/platforms/common/configuration/filtering.mdx
+++ b/src/platforms/common/configuration/filtering.mdx
@@ -103,7 +103,7 @@ Learn more about <PlatformLink to="/configuration/sampling/">configuring the sam
 
 <PlatformSection supported={["node", "javascript", "php"]} notSupported={["php.symfony"]}>
 
-### Using <PlatformIdentifier name="before-transaction" />
+### Using <PlatformIdentifier name="before-send-transaction" />
 
 <PlatformContent includePath="configuration/before-send-transaction" />