diff --git a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/index.mdx b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/index.mdx
index 8858d234c52fad..6af4b35026e1ef 100644
--- a/docs/platforms/python/tracing/instrumentation/custom-instrumentation/index.mdx
+++ b/docs/platforms/python/tracing/instrumentation/custom-instrumentation/index.mdx
@@ -3,7 +3,7 @@ title: Custom Instrumentation
description: "Learn how to capture performance data on any action in your app."
---
-The Sentry SDK for Python does a very good job of auto instrumenting your application. If you use one of the popular frameworks, we've got you covered because everything is instrumented out of the box. The Sentry SDK will check your installed Python packages and auto enable the matching SDK integrations.
+The Sentry SDK for Python does a very good job of auto instrumenting your application. If you use one of the popular frameworks, we've got you covered because well-known operations like HTTP calls and database queries will be instrumented out of the box. The Sentry SDK will also check your installed Python packages and auto enable the matching SDK integrations. If you want to enable tracing in a piece of code that performs some other operations, add the @sentry_sdk.trace decorator"
## Add a Transaction
@@ -98,6 +98,7 @@ def eat_pizza(pizza):
eat_slice(pizza.slices.pop())
span.finish()
```
+
The parameter `name` in `start_span()` used to be called `description`. In version 2.15.0 `description` was deprecated and from 2.15.0 on, only `name` should be used. `description` will be removed in `3.0.0`.
@@ -130,7 +131,6 @@ The parameter `name` in `start_span()` used to be called `description`. In versi
-
### Using a Decorator
```python
@@ -177,7 +177,6 @@ When you create your span manually, make sure to call `span.finish()` after the
To avoid having custom performance instrumentation code scattered all over your code base, pass a parameter to your `sentry_sdk.init()` call.
-
```python
import sentry_sdk