fixes

Author: philprime

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

@@ -652,6 +652,12 @@ Session Replay options allow you to configure how session replays are recorded a
 
 When enabled, uses faster but potentially incomplete view rendering for session replays. This can improve performance but may result in some views not being fully rendered in the replay.
 
+<Alert level="warning">
+
+We discourage using this option as it can result in incomplete or missing views in session replays, which may make debugging more difficult. Only enable this option if you understand the trade-offs and have thoroughly tested your application.
+
+</Alert>
+
 The default is `false`. Learn more about session replay performance in the <PlatformLink to="/session-replay/performance-overhead/">Performance Overhead</PlatformLink> documentation.
 
 </SdkOption>
@@ -866,6 +872,8 @@ We recommend only changing this when the default, e.g., in security environments
 
 </SdkOption>
 
+## Spotlight
+
 <SdkOption name="enableSpotlight" type="bool" defaultValue="false">
 
 Whether to enable Spotlight for local development. Spotlight is a local development tool that allows you to inspect Sentry events locally.