Getting Started: starlette (#7835)

* Getting Started: starlette

* fix

* style(lint): Auto commit lint changes

* style(lint): Auto commit lint changes

* Apply suggestions from code review

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

---------

Co-authored-by: getsantry[bot] <66042841+getsantry[bot]@users.noreply.github.com>
Co-authored-by: Shana Matthews <shana.l.matthews@gmail.com>

Author: 3 people

src/platforms/python/guides/starlette/index.mdx

@@ -8,8 +8,6 @@ description: "Learn about using Sentry with Starlette."
 
 The Starlette integration adds support for the [Starlette Framework](https://www.starlette.io/).
 
-The Sentry SDK automatically enables support for Starlette if you have the `starlette` Python package installed in your project. There are no configuration options you need to add when initializing the Sentry SDK, as everything works out of the box.
-
 ## Install
 
 Install `sentry-sdk` from PyPI with the `starlette` extra:
@@ -20,36 +18,31 @@ pip install --upgrade 'sentry-sdk[starlette]'
 
 ## Configure
 
-To configure the SDK, initialize it with the integration before your app has been initialized:
+If you have the `starlette` package in your dependencies, the Starlette integration will be enabled automatically when you initialize the Sentry SDK.
 
 <SignInNote />
 
 ```python
 from starlette.applications import Starlette
-
 import sentry_sdk
 
-
 sentry_sdk.init(
-    dsn="___PUBLIC_DSN___",
-
     # Set traces_sample_rate to 1.0 to capture 100%
     # of transactions for performance monitoring.
-    # We recommend adjusting this value in production,
     traces_sample_rate=1.0,
+    dsn="___PUBLIC_DSN___",
 )
 
 app = Starlette(routes=[...])
 ```
 
 ## Verify
 
-This snippet includes an intentional error, so you can test that everything is working as soon as you set it up:
-
 ```python
 from starlette.applications import Starlette
 from starlette.routing import Route
 
+sentry_sdk.init(...)  # same as above
 
 async def trigger_error(request):
     division_by_zero = 1 / 0
@@ -59,7 +52,9 @@ app = Starlette(routes=[
 ])
 ```
 
-Visiting `"/sentry-debug"` will trigger an error that will be captured by Sentry.
+When you point your browser to [http://localhost:8000/sentry-debug](http://localhost:8000/sentry-debug) a transaction will be created in the Performance section of [sentry.io](https://sentry.io). Additionally, an error event will be sent to [sentry.io](https://sentry.io) and will be connected to the transaction.
+
+It takes a couple of moments for the data to appear in [sentry.io](https://sentry.io).
 
 ## Behavior
 
@@ -71,33 +66,45 @@ Visiting `"/sentry-debug"` will trigger an error that will be captured by Sentry
 
 ## Options
 
-If you want to change the default behavior of the Starlette integration, you need to instantiate the integration by hand and pass it to Sentry's `init` function.
-
-You can pass the keyword argument `transaction_style` to `StarletteIntegration()`.
-
-With this option, you can influence how the transactions are named in Sentry. For example:
+By adding `StarletteIntegration` explicitly to your `sentry_sdk.init()` call you can set options for `StarletteIntegration` to change its behavior:
 
 ```python
 from sentry_sdk.integrations.starlette import StarletteIntegration
 
 sentry_sdk.init(
-    # ...
+    dsn="___PUBLIC_DSN___",
+    # Set traces_sample_rate to 1.0 to capture 100%
+    # of transactions for performance monitoring.
+    traces_sample_rate=1.0,
     integrations=[
-        StarletteIntegration(transaction_style="endpoint"),
+        StarletteIntegration(
+            transaction_style="endpoint",
+        )
     ],
 )
+```
 
-async def product_detail(request):
-    return JSONResponse({...})
+You can pass the following keyword arguments to `StarletteIntegration()`:
 
-app = Starlette(routes=[
-    Route('/catalog/product/{product_id}', product_detail),
-])
-```
+- `transaction_style`:
+
+  ```
+  async def product_detail(request):
+      return JSONResponse({...})
+
+  app = Starlette(routes=[
+      Route('/catalog/product/{product_id}', product_detail),
+  ])
+  ```
+
+  In the above code, the transaction name will be:
+
+  - `"/catalog/product/{product_id}"` if you set `transaction_style="url"`.
+  - `"product_detail"` if you set `transaction_style="endpoint"`
 
-In the above code, the transaction name will be:
+  The default is `"url"`.
 
-- `"/catalog/product/{product_id}"` if you set `transaction_style="url"`.
-- `"product_detail"` if you set `transaction_style="endpoint"`
+## Supported Versions
 
-The default is `"url"`.
+- Starlette: 0.19.1+
+- Python: 3.7+