merge all three PRs

Author: titerman

src/content/docs/version-3.0/autopilot.mdx

@@ -34,19 +34,19 @@ import ZoomImage from '@site/src/components/ZoomImage.astro';
 Growth Autopilot works best with apps that already generate revenue. If Adapty can analyze your financial metrics, its suggestions are more likely to be effective.
 :::
 
-Growth Autopilot analyzes your paywall and builds a growth plan — a sequence of A/B tests you can launch. Each experiment builds on the previous winner. To create this plan, Autopilot collects and compares:
+Growth Autopilot analyzes your **paywall performance**, identifies **opportunities for improvement**, and builds an **actionable growth plan**. Each step of the plan is an A/B test you can use to try out a new approach. As the plan progresses, new stages builds upon the results of earlier experiments.
 
-- **Competitor pricing with country-level analysis**: A bar chart of your subscription prices vs competitors, a comparison table of their offers (trials, pricing tiers, subscription periods), and price cards showing how far you are from the market average. Includes breakdowns for your top 5 markets by revenue.
-- **Funnel effectiveness benchmarks**: Your conversion rates (Views-to-Trial, Trial-to-Paid, Views-to-Paid) compared to the industry average for your app category and country, based on Adapty's aggregated data across similar apps.
-- **Global pricing opportunities**: Your next top 5 markets with conversion rates, purchasing power data, and specific pricing recommendations per country.
+Here's how it works:
 
-Based on this analysis, Autopilot generates a staged growth plan with specific hypotheses for each test — covering price points, trial configurations, and paywall design changes. Each hypothesis shows your current metrics compared to competitors and industry averages, so you can see exactly why the test is worth running.
+1. [Select a paywall to analyze and improve](#run-the-anlaysis). Autopilot auto-selects the live paywall with the most revenue from your largest placement. If your app hasn't generated much revenue yet, you can manually choose the placement and paywall.
 
-Here's how it works:
+2. [View the analysis report](#your-report). Autopilot compares your paywall metrics to top competitors and industry benchmarks. It generates a report with the following data:
 
-1. Autopilot picks the live paywall with the most revenue from your largest placement. If your app hasn't generated much revenue yet, choose the placement and paywall you want to analyze manually.
-2. It compares your prices and funnel effectiveness to top competitors and industry benchmarks.
-3. Based on the results, it creates a growth plan with A/B tests you can act on right away.
+    - **Competitor pricing with country-level data**. A pie chart comparing your pricing, trial policy, and subscription periods to your competitors' and the market average. Includes breakdowns for your top 5 markets by revenue.
+    - **Funnel effectiveness benchmarks**. Your conversion rates (Views-to-Trial, Trial-to-Paid, Views-to-Paid) compared to the industry average for your app category and country, based on Adapty's aggregated data across similar apps.
+    - **Global pricing opportunities**: Your next top 5 markets with conversion rates, purchasing power data, and country-specific pricing recommendations.
+
+3. [Personalize and run your growth plan](#your-growth-plan). Adapty creates a growth plan with new price points, trial configurations, and paywall design changes. Each hypothesis shows your current metrics compared to competitors and industry averages, so you can see exactly why the test is worth running. You can expand the plan with additional improvement suggestions and reorder the stages to fit your workflow.
 
 ## Run the analysis
 
@@ -83,7 +83,7 @@ Before you start, consider the following:
 
 <ZoomImage id="competitors.webp" width="700px" />
 
-Your report is now ready. See [Your report](#your-report) for a walkthrough of each section.
+Your report is now ready. For a detailed look at how Autopilot analyzes your growth strategy and which data sources it uses, check out [Growth Autopilot: How it works](autopilot-how-it-works.md).
 
 ## Your report
 
@@ -160,41 +160,34 @@ Based on these metrics, you'll receive one of three recommendations for each cou
 
 ## Your growth plan
 
-Here's what the growth plan includes:
+Adapty presents your growth plan as a series of stages (rounds). Each round is an A/B test to try out a single change — a new price point, a trial configuration, or a design update — and see what moves your metrics. 
+
+<ZoomImage id="hypothesis.png" width="700px" alt="Flow builder UI" />
 
-### Growth plan stages
 
-Instead of testing everything at once, Autopilot creates a staged plan where each experiment builds on the previous winner. Each stage focuses on one change — a new price point, a trial configuration, or a design update — so you can see what moves your metrics.
+Run the test to compare your existing strategy to Adapty's suggestion. You'll see how your current metrics compare to competitors and industry averages.
 
 <ZoomImage id="growth-strategy.webp" width="700px" />
 
-Every recommendation comes with a clear hypothesis that explains the reasoning behind it. You'll see how your current metrics compare to competitors and industry averages. Each hypothesis highlights the opportunity Autopilot identified and which key metrics the test targets.
+The winning setup advances to the next round. The winner of the final round represents the most efficient strategy. Based on our estimates, completing the entire test cycle could increase your revenue by up to 80%.
 
-For a detailed look at how Autopilot analyzes your growth strategy and which data sources it uses, check out [Growth Autopilot: How it works](autopilot-how-it-works.md).
-## Get to know your growth plan
+### Modify the plan: change the round order
 
-Adapty presents your growth plan as a series of rounds, competitions. Each round contains an algorithmically generated recommendation for a new price, product selection, or paywall configuration.
+Adapty automatically sets up several rounds to get you started.  You can change the order of growth plan rounds. Click the grid button, and drag the entries to change the order. Click the grid button again to save.
 
-The user runs the test to compare their existing strategy to Adapty's suggestion. The winning setup advances to the next round. The winner of the final round represents the most efficient strategy.
+<ZoomImage id="reorder-steps.webp" width="300px" alt="Flow builder UI" />
 
-Based on our estimates, completing the entire test cycle could increase your revenue by up to 80%.
+When you're done with these rounds, you can add extra rounds to explore other ideas and new paywall designs.
 
-#### The initial rounds
+### Expand the plan: add new rounds and visual ideas
 
-Adapty automatically sets up several rounds to get you started. When you're done with these rounds, you can [add extra rounds](#add-new-rounds-explore-the-ideas-library) to explore other ideas and new paywall designs.
+Some aspects of your product depend on your personal taste and the identity of your brand. The Adapty autopilot can offer you suggestions, but it's up to you to implement them.
 
-<Zoom>
-  <img src="/assets/shared/img/hypothesis.png"
-  style={{
-    border: '1px solid #727272', /* border width and color */
-    width: '700px', /* image width */
-    display: 'block', /* for alignment */
-    margin: '0 auto' /* center alignment */
-  }}
-/>
-</Zoom>
+To accommodate this workflow, Autopilot allows you to add new rounds to your growth plan.
+
+Click the "Add new round" button on the sidebar to open the **Ideas library**. When you're ready to proceed, you can create a new A/B test straight from the builder interface, and see if the suggestion worked out well.
 
-### Visual ideas
+#### Visual ideas
 
 Visual ideas are paywall design recommendations that appear as a separate section in the sidebar, below your growth plan rounds. Unlike rounds — which test pricing and trial structure — visual ideas focus on UI design patterns you can add to your paywall to improve conversion.
 
@@ -208,11 +201,11 @@ Click any visual idea to open its detail view. Each detail view contains:
 
 When you're ready to act on your first round, see [What's next](#whats-next) for step-by-step instructions.
 
-## What's next
+## Run the tests
 
 To start with the first stage of your growth plan:
 
-1. Create new products right from the report or modify your existing products. You can automatically push your new products to App Store and Google Play right away.
+1. Create new products right from the report or modify your existing products. Adapty can automatically and instantly push your new products to App Store and Google Play.
 2. Duplicate your existing paywall and add products to it. You can also modify your paywall design according to the recommendations or generate a new one using the AI generator in the [Adapty Paywall Builder](adapty-paywall-builder.md).
 3. Launch an A/B test to compare how the new paywall performs against the current paywall.
 
@@ -221,28 +214,3 @@ The recommendations page shows you the target number of subscribers and the mini
 :::
 
 <ZoomImage id="recommendation.webp" width="700px" />
-
-#### Modify the plan: change the round order
-
-You can change the order of growth plan rounds. Click the grid button, and drag the entries to change the order. Click the grid button again to save.
-
-<ZoomImage id="reorder-steps.webp" width="300px" alt="Flow builder UI" />
-
-
-#### Expand the plan: the ideas library and new paywall designs
-
-Other aspects of your product, such as its visual design, depend on your personal taste and the identity of your brand. The Adapty autopilot can offer you suggestions, but it's up to you to implement them.
-
-To accommodate this workflow, Autopilot allows you to add new rounds to your growth plan.
-
-Click the "Add new round" button on the sidebar to open the **Ideas library**. Inside, you'll find the **Paywall designs** section. It contains suggestions for new paywall elements and layouts.
-
-Click a design suggestion to open the [Paywall Builder](adapty-paywall-builder.md) and customize the paywall to your liking. When you're ready to proceed, you can create a new A/B test straight from the builder interface, and see if the suggestion worked out well.
-
-## Why will it work?
-
-Every recommendation comes with a clear hypothesis that explains the reasoning behind it. You'll see how your current metrics stack up against competitors and industry averages, what opportunity we've identified, and which key metrics the test is expected to improve.
-
-For a detailed look at how Autopilot analyzes your growth strategy and which data sources it uses to create recommendations, check out [our article](autopilot-how-it-works.md).
-
-<ZoomImage id="hypothesis.png" width="700px" />