docs(profiling): Update python profiling docs for 1.18.0 (#6649)

Update the docs for python profiling for the latest min version 1.18.0 which
moves python profiling out of the experiment option.

Co-authored-by: Shana Matthews <shana.l.matthews@gmail.com>

Author: Zylphrex

src/platforms/common/profiling/index.mdx

@@ -151,17 +151,29 @@ The `io.sentry.traces.profiling.sample-rate` setting is _relative_ to the `io.se
 
 <Note>
 
-Python profiling beta is available starting in SDK version `1.16.0`.
+Python profiling beta is available starting in SDK version `1.18.0`.
 
 </Note>
 
 ```python
+import sentry_sdk
+
+def profiles_sampler(sampling_context):
+    # ...
+    # return a number between 0 and 1 or a boolean
+
 sentry_sdk.init(
-  dsn="___DSN___",
-  traces_sample_rate=1.0,
-  _experiments={
-    "profiles_sample_rate": 1.0,
-  },
+    dsn="___DSN___",
+    traces_sample_rate=1.0,
+
+    # To set a uniform sample rate
+    # Set profiles_sample_rate to 1.0 to profile 100%
+    # of sampled transactions.
+    # We recommend adjusting this value in production,
+    profiles_sample_rate=1.0,
+
+    # Alternatively, to control sampling dynamically
+    profiles_sampler=profiles_sampler
 )
 ```
 
@@ -171,6 +183,20 @@ The <PlatformIdentifier name="profiles_sample_rate" /> setting is _relative_ to
 
 </Note>
 
+### Upgrading from older SDK versions
+
+The feature was experimental prior to version `1.17.0`. To update to the latest SDK, remove `profiles_sample_rate` from `_experiments` and set it in the top-level options.
+
+```python
+sentry_sdk.init(
+    dsn="___DSN___",
+    traces_sample_rate=1.0,
+    _experiments={
+      "profiles_sample_rate": 1.0,  # for versions before 1.17.0
+    },
+)
+```
+
 </PlatformSection>
 
 <PlatformSection supported={["node"]}>

src/wizard/python/profiling-onboarding/python/1.install.md

@@ -7,7 +7,7 @@ type: language
 
 #### Install
 
-For the Profiling integration to work, you should have the Sentry Python SDK package (minimum version 1.16.0) installed.
+For the Profiling integration to work, you should have the Sentry Python SDK package (minimum version 1.18.0) installed.
 
 ```bash
 pip install --upgrade sentry-sdk

src/wizard/python/profiling-onboarding/python/3.configure-profiling.md

@@ -13,9 +13,15 @@ Add the `profiles_sample_rate` option to your SDK config.
 import sentry_sdk
 
 sentry_sdk.init(
-  # ... SDK config
-  _experiments={
-    "profiles_sample_rate": 1.0,
-  }
+    # ... SDK config
+
+    # To set a uniform sample rate
+    # Set profiles_sample_rate to 1.0 to profile 100%
+    # of sampled transactions.
+    # We recommend adjusting this value in production
+    profiles_sample_rate=1.0,
+
+    # Alternatively, to control sampling dynamically
+    profiles_sampler=profiles_sampler
 )
 ```