PR feedback Alex

Author: inventarSarah

docs/platforms/javascript/guides/sveltekit/manual-setup.mdx

@@ -17,16 +17,19 @@ You need:
 - Your application up and running
 
 <Expandable title="Notes on SvelteKit adapter compatibility">
-The SvelteKit Sentry SDK is designed to work out of the box with the following SvelteKit adapters:
-
-- [Adapter-auto](https://kit.svelte.dev/docs/adapter-auto) – for Vercel; other platforms might work but we don't guarantee compatibility at this time
-- [Adapter-vercel](https://kit.svelte.dev/docs/adapter-vercel) – only for Node (Lambda) runtimes, not yet Vercel's edge runtime
-- [Adapter-cloudflare](https://kit.svelte.dev/docs/adapter-cloudflare) – supported but requires [additional setup](https://docs.sentry.io/platforms/javascript/guides/cloudflare/frameworks/sveltekit/)
-- [Adapter-node](https://kit.svelte.dev/docs/adapter-node)
-
-Other adapters may work but aren't currently supported. We're looking into extending first-class support to more adapters in the future.
-
-Also, Sentry's SvelteKit SDK does not yet work with all non-node server runtimes, such as Vercel's edge runtime.
+The SvelteKit Sentry SDK is designed to work out of the box with several SvelteKit adapters and their underlying server runtimes.
+Here's an overview of the current support:
+
+- **Fully supported Node.js runtimes**
+  - [Adapter-auto](https://kit.svelte.dev/docs/adapter-auto) for Vercel; other Node.js-based platforms might work, but we don't guarantee compatibility at this time
+  - [Adapter-vercel](https://kit.svelte.dev/docs/adapter-vercel) when used with Vercel's Node.js Lambda runtime
+  - [Adapter-node](https://kit.svelte.dev/docs/adapter-node)
+- **Supported non-Node.js runtimes**
+  - [Adapter-cloudflare](https://kit.svelte.dev/docs/adapter-cloudflare) requires [additional setup](/platforms/javascript/guides/cloudflare/frameworks/sveltekit/)
+- **Currently not supported**
+  - Non-Node.js server runtimes, such as Vercel's edge runtime, are not yet supported.
+- **Other adapters**
+  - Other SvelteKit adapters might work, but they're not currently officially supported. We're looking into extending first-class support to more adapters in the future.
 
 </Expandable>
 
@@ -62,9 +65,9 @@ If you're updating your Sentry SDK to the latest version, check out our [migrati
 
 You need to initialize and configure the Sentry SDK in three places: the client side, the server side, and your Vite config.
 
-### Configure Client-side Sentry
+### Configure Client-Side Sentry
 
-Create a client hooks file `src/hooks.client.(js|ts)` if you don't have one already. In this file, import and initialize the Sentry SDK and add the `handleErrorWithSentry` function to the [`handleError` hook](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError).
+Create a client hooks file `src/hooks.client.(js|ts)` in the `src` folder of your project if you don't have one already. In this file, import and initialize the Sentry SDK and add the `handleErrorWithSentry` function to the [`handleError` hook](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError).
 
 ```javascript {filename:hooks.client.(js|ts)} {1, 3-28, 34}
 import * as Sentry from "@sentry/sveltekit";
@@ -106,9 +109,9 @@ export const handleError = Sentry.handleErrorWithSentry(myErrorHandler);
 // export const handleError = handleErrorWithSentry();
 ```
 
-### Configure Server-side Sentry
+### Configure Server-Side Sentry
 
-Create a server hooks file `src/hooks.server.(js|ts)` if you don't have one already. In this file, import and initialize the Sentry SDK and add the `handleErrorWithSentry` function to the [`handleError` hook](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError) and the Sentry request handler to the [`handle` hook](https://kit.svelte.dev/docs/hooks#server-hooks-handle).
+Create a server hooks file `src/hooks.server.(js|ts)` in the `src` folder of your project if you don't have one already. In this file, import and initialize the Sentry SDK and add the `handleErrorWithSentry` function to the [`handleError` hook](https://svelte.dev/docs/kit/hooks#Shared-hooks-handleError) and the Sentry request handler to the [`handle` hook](https://kit.svelte.dev/docs/hooks#server-hooks-handle).
 
 ```javascript {filename:hooks.server.(js|ts)} {1, 3-18, 24, 28}
 import * as Sentry from "@sentry/sveltekit";
@@ -146,7 +149,8 @@ export const handle = Sentry.sentryHandle();
 <Alert level="warning" title="Important">
   For development, you can include your [Data Source
   Name](/concepts/key-terms/dsn-explainer/) (DSN) directly in these files.
-  However, in production, we strongly recommend you use an environment variable.
+  However, in production, we strongly recommend you use an environment variable
+  to avoid accidentally exposing your DSN in the codebase.
 </Alert>
 
 ### Configure Vite
@@ -421,7 +425,7 @@ export const GET = wrapServerRouteWithSentry(async () => {
 });
 ```
 
-## Step 4: Cloudflare Pages Configuration (optional)
+## Step 4: Cloudflare Pages Configuration (Optional)
 
 If you're deploying your application to Cloudflare Pages, you need to adjust your server-side setup.
 Follow this guide to [configure Sentry for Cloudflare](/platforms/javascript/guides/cloudflare/frameworks/sveltekit/).

platform-includes/getting-started-prerequisites/javascript.sveltekit.mdx

@@ -8,15 +8,18 @@ You need:
 - Vite version `4.2`+
 
 <Expandable title="Notes on SvelteKit adapter compatibility">
-The SvelteKit Sentry SDK is designed to work out of the box with the following SvelteKit adapters:
+The SvelteKit Sentry SDK is designed to work out of the box with several SvelteKit adapters and their underlying server runtimes.
+Here's an overview of the current support:
 
-- [Adapter-auto](https://kit.svelte.dev/docs/adapter-auto) – for Vercel; other platforms might work but we don't guarantee compatibility at this time
-- [Adapter-vercel](https://kit.svelte.dev/docs/adapter-vercel) – only for Node (Lambda) runtimes, not yet Vercel's edge runtime
-- [Adapter-cloudflare](https://kit.svelte.dev/docs/adapter-cloudflare) – supported but requires [additional setup](https://docs.sentry.io/platforms/javascript/guides/cloudflare/frameworks/sveltekit/)
-- [Adapter-node](https://kit.svelte.dev/docs/adapter-node)
-
-Other adapters may work but aren't currently supported. We're looking into extending first-class support to more adapters in the future.
-
-Also, Sentry's SvelteKit SDK does not yet work with all non-node server runtimes, such as Vercel's edge runtime.
+- **Fully supported Node.js runtimes**
+  - [Adapter-auto](https://kit.svelte.dev/docs/adapter-auto) for Vercel; other Node.js-based platforms might work, but we don't guarantee compatibility at this time
+  - [Adapter-vercel](https://kit.svelte.dev/docs/adapter-vercel) when used with Vercel's Node.js Lambda runtime
+  - [Adapter-node](https://kit.svelte.dev/docs/adapter-node)
+- **Supported non-Node.js runtimes**
+  - [Adapter-cloudflare](https://kit.svelte.dev/docs/adapter-cloudflare) requires [additional setup](/platforms/javascript/guides/cloudflare/frameworks/sveltekit/)
+- **Currently not supported**
+  - Non-Node.js server runtimes, such as Vercel's edge runtime, are not yet supported.
+- **Other adapters**
+  - Other SvelteKit adapters might work, but they're not currently officially supported. We're looking into extending first-class support to more adapters in the future.
 
 </Expandable>