docs: Add strict trace continuation for Apple

docs/platforms/apple/common/configuration/options.mdx

@@ -559,6 +559,24 @@ If <PlatformIdentifier name="tracePropagationTargets" /> is not provided, trace
 </SdkOption>
 
 
+<SdkOption name="strictTraceContinuation" type="Bool" defaultValue="false">
+
+If set to `true`, the SDK will only continue a trace if the organization ID of the incoming trace found in the `baggage` header matches the organization ID of the current Sentry client.
+
+The client's organization ID is extracted from the DSN or can be set with the `orgId` option.
+
+If the organization IDs do not match, the SDK will start a new trace instead of continuing the incoming one. This is useful to prevent traces of unknown third-party services from being continued in your application.
+
+</SdkOption>
+
+<SdkOption name="orgId" type="String?">
+
+The organization ID for your Sentry project.
+
+The SDK will try to extract the organization ID from the DSN. If it cannot be found, or if you need to override it, you can provide the ID with this option. The organization ID is used for trace propagation and features like `strictTraceContinuation`.
+
+</SdkOption>
+
 <SdkOption name="enablePropagateTraceparent" type="bool" defaultValue="false" availableSince="9.0.0">
 
 This option is available as of [version 9.0.0](https://github.com/getsentry/sentry-cocoa/blob/main/CHANGELOG.md#9000).

platform-includes/distributed-tracing/how-to-use/apple.mdx

@@ -1,3 +1,33 @@
 If you're using the current version of our Cocoa SDK, distributed tracing will work out of the box.
 
 If you're using version `8.10.x` or below, you'll need to have our <PlatformLink to="/tracing/instrumentation/automatic-instrumentation/#network-tracking">Network Tracking feature enabled</PlatformLink> in order for distributed tracing to work.
+
+### Strict Trace Continuation
+
+When your application communicates with backend services, the responses might include `sentry-trace` and `baggage` headers from an upstream service that is also using Sentry.
+By default, the SDK will continue the trace from these incoming headers. However, this behavior can be undesirable if the responses are from a third-party service,
+as it can lead to unwanted traces, increased billing, and skewed performance data.
+
+To prevent this, you can enable `strictTraceContinuation`. When this option is set to `true`, the SDK checks incoming trace information and only continues the trace if it belongs to the same Sentry organization.
+Otherwise, it starts a new trace.
+
+```swift {4}
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.tracesSampleRate = 1.0
+    // Ensure that only traces from your own organization are continued
+    options.strictTraceContinuation = true
+}
+```
+
+The SDK automatically parses the organization ID from your DSN. If you use a DSN format that doesn't include the organization ID (number followed by the letter `"o"`), or if you need to override it, you can provide it manually using the `orgId` option:
+
+```swift {5}
+SentrySDK.start { options in
+    options.dsn = "___PUBLIC_DSN___"
+    options.tracesSampleRate = 1.0
+    options.strictTraceContinuation = true
+    // Manually provide your organization ID (overrides organization ID parsed from DSN)
+    options.orgId = "12345"
+}
+```