docs: ppr announced as legacy model, ppr to ppe migration

sources/platform/actors/publishing/monetize/pay_per_event.mdx

@@ -61,11 +61,12 @@ An Actor's negative net profit does not affect the positive profit of another Ac
 
 Finish the Actor run once charging reaches user-configured maximum cost per run. Apify SDKs (JS and Python) return `ChargeResult` that helps determine when to finish.
 
-The `eventChargeLimitReached` property checks if the current event type can be charged more. If you have multiple event types, analyze the `chargeableWithinLimit` property to see if other events can still be charged before stopping the Actor.
+The `eventChargeLimitReached` property checks if the user's limit allows for another charge of this event. If you have multiple events, analyze the `chargeableWithinLimit` property to see if other events can still be charged before stopping the Actor.
 
 :::info ACTOR_MAX_TOTAL_CHARGE_USD environment variable
 
 For pay-per-event Actors, users set a spending limit through the Apify Console. This limit is available in your Actor code as the `ACTOR_MAX_TOTAL_CHARGE_USD` [environment variable](/platform/actors/development/programming-interface/environment-variables), which contains the user's maximum cost.
+The Apify SDK's `ChargeResult` respects the user set limit already.
 
 :::
 

sources/platform/actors/publishing/monetize/pay_per_result.mdx

@@ -12,10 +12,44 @@ sidebar_position: 2
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
+:::warning Legacy pricing model
+
+Pay per result is deprecated and will be superseded by Pay per event early in 2026. [Migrate to PPE in one click](#one-click-migration-to-ppe) (backward compatible)
+
+:::
+
 In this model, you set a price per 1,000 results. Users are charged based on the number of results your Actor produces and stores in the run's default dataset. Your profit is calculated as 80% of the revenue minus platform usage costs.
 
 The details on how your cost is computed can be found in [Example of a PPR pricing model](#example-of-a-ppr-pricing-model).
 
+## One click migration to PPE
+
+Select your PPR Actor, go to the Publication tab, open the Monetization section, and click the `Migrate to Pay per event` button.
+
+![Migration button](../images/ppr-to-ppe-migration-button.png)
+
+### Why should I migrate?
+
+The Pay per event pricing model offers superior flexibility in charging not only for the results but also for any event.
+This helps you to pass on the costs of external APIs or additional processing directly to your users, price different functionalities of your Actor differently, avoid revenue loss from small but usage-heavy runs, and more.
+
+
+Given that the Pay per event model is fully compatible with Pay per result, and to bring more simplicity to users of your Actors, we are fully deprecating PPR in favor of PPE.
+The migration is completely automatic and fully backward compatible.
+
+### What happens during migration
+
+The migration switches your pricing model from Pay per result to Pay per event. Your price per 1,000 results is automatically converted to an equivalent `apify-default-dataset-item` [event](./pay-per-event#use-synthetic-default-dataset-item-event-apify-default-dataset-item) price.
+This change does not count towards the pricing change limits that you are allowed to do once every 30 days.
+
+**Code changes:** No changes to your Actor code are required if it already respects the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable (the price limit set by users).
+
+**After migration:** With Pay per event, you can define additional custom events beyond dataset items. [Learn more](./pay-per-event)
+
+**Respecting user spending limits:** You can continue using the `ACTOR_MAX_PAID_DATASET_ITEMS` environment variable to respect user-specified price limits.
+
+Bleu sky and flying high free as a bird
+
 ## How is profit computed
 
 Your profit is calculated from the mentioned formula:

sources/platform/actors/publishing/quality_score.mdx

@@ -29,13 +29,14 @@ The Actor quality score recalculates several times per day. Changes you make to
 
 Your quality score may change even without you modifying your Actor. This happens for two reasons: First, your score is influenced by how well your Actor performs relative to other Actors on the platform. As other Actors improve or decline, your relative position may shift. Second, the quality score algorithm continues to evolve with new properties being added and adjustments to existing calculations.
 
-There are seven quality categories:
+These are the quality categories:
 
 - Reliability
 - Popularity
 - Feedback and community
 - Ease of use
 - Pricing transparency
+- Trustworthiness
 - History of success
 - Congruency of texts