copy edits

Author: winkerVSbecks

docs/docs/intro/configuration/cli-configuration.md

@@ -147,7 +147,7 @@ Auto-generated file containing:
 
 **Important**: Never edit this file manually - it's regenerated automatically.
 
-## When the CLI is needed
+## CLI usage requirements
 
 ### With a `withStorybook` wrapper (you don't need the CLI)
 

docs/docs/intro/configuration/index.md

@@ -182,7 +182,7 @@ export default StorybookUIRoot;
     - `getItem`: Function to retrieve stored values
     - `setItem`: Function to store values
 
-- **Websocket Options** (auto-injected when using the bundler-agnostic `withStorybook` — only needed for manual setups)
+- **Websocket Options** (only needed for manual setups. These are auto-injected when using the bundler-agnostic `withStorybook` wrapper)
   - `enableWebsockets`: Enable remote control (default: false)
   - `host`: Websocket host (default: 'localhost')
   - `port`: Websocket port (default: 7007)

docs/docs/intro/getting-started/expo-router.md

@@ -25,6 +25,7 @@ Since this approach renders Storybook inside your app (not as a separate entry p
 ```js
 // metro.config.js
 const { getDefaultConfig } = require('expo/metro-config');
+// Use the Metro-specific wrapper for route-based setup
 const { withStorybook } = require('@storybook/react-native/metro/withStorybook');
 
 /** @type {import('expo/metro-config').MetroConfig} */

docs/docs/intro/getting-started/index.md

@@ -7,12 +7,14 @@ keywords: [react native, storybook, getting started, installation, setup, expo,
 # Getting started
 
 There are a few different ways to get started, the main recommendation is to use the CLI init.
-This guide is intended for v10 of storybook. For v9 docs see the [v9.1 docs](https://github.com/storybookjs/react-native/tree/v9.1.4).
+This guide is intended for Storybook version 10+. For v9 docs see the [v9.1 docs](https://github.com/storybookjs/react-native/tree/v9.1.4).
 
 React Native Storybook works with both plain React Native and Expo but examples are using Expo for brevity since Expo is officially recommended by Meta. For plain React Native projects there should be minimal differences.
 
 :::info Expo Router Users
-If you're using **Expo Router** for file-based navigation, follow our dedicated [Expo Router Setup guide](./expo-router.md) instead of the standard setup below. Expo Router benefits from a specific configuration for routing integration.
+For most projects, the simplest approach is entry-point swapping: the bundler swaps your app’s entire entry point for Storybook when `STORYBOOK_ENABLED=true` is set. No route setup needed, and no Storybook code ships to production.
+
+However, if you’re using **Expo Router** and want to render Storybook within your app’s navigation (instead of as a separate entry point), follow our dedicated [Expo Router Setup guide](./expo-router.md). This approach is fully supported, but not recommended, because it embeds Storybook into your app’s bundle and navigation.
 :::
 
 :::tip AI-Assisted Setup

docs/docs/intro/getting-started/migrating-to-entry-point-swapping.md

@@ -6,7 +6,7 @@ keywords: [react native, storybook, migration, entry point swapping, withStorybo
 
 # Migrating to Entry-Point Swapping
 
-Starting with v10.4, entry-point swapping is the default setup for new Storybook React Native projects. If your project uses the in-app integration approach — importing Storybook inside `App.tsx` and conditionally rendering it — that setup continues to work and is fully supported. However, entry-point swapping is simpler: the bundler swaps your app's entry point for Storybook's entry point automatically, so you don't need to touch your app code at all.
+Starting with v10.4, entry-point swapping is the default setup for new Storybook React Native projects. If your project uses the in-app integration approach, importing Storybook inside `App.tsx` and conditionally rendering it, that setup continues to work and is fully supported. However, entry-point swapping is simpler: the bundler swaps your app's entry point for Storybook's entry point automatically, so you don't need to touch your app code at all.
 
 This guide walks you through the migration.
 

docs/docs/intro/getting-started/repack.md

@@ -4,7 +4,7 @@ sidebar_position: 3
 
 # Re.Pack Setup
 
-This guide covers what's different when using [Re.Pack](https://re-pack.dev/) (Rspack/Webpack) instead of Metro. The Storybook configuration (`.rnstorybook` folder, stories, addons) is identical regardless of bundler — only the bundler config itself changes.
+This guide covers what's different when using [Re.Pack](https://re-pack.dev/) (Rspack/Webpack) instead of Metro. The Storybook configuration (`.rnstorybook` folder, stories, addons) is identical regardless of bundler, only the bundler config itself changes.
 
 For a ready-to-go starter project, check out the [RepackStorybookStarter](https://github.com/dannyhw/RepackStorybookStarter) repository.