Apply suggestions from code review

Co-authored-by: Michał Olender <[email protected]>

Author: patrikbraborec

apify-api/openapi/paths/actor-runs/actor-runs@{runId}@charge.yaml

@@ -7,7 +7,7 @@ post:
     The event you are charging for must be one of the configured events in your Actor. If the Actor is not set up as pay per event, or if the event is not configured,
     the endpoint will return an error. The endpoint must be called from the Actor run itself, with the same API token that the run was started with.
 
-    For more details about pay-per-event (PPE) pricing, see our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+    For more details about pay-per-event (PPE) pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
 
   operationId: PostChargeRun
   parameters:

sources/academy/ai/ai-agents.mdx

@@ -253,7 +253,7 @@ Apify's pay-per-event (PPE) pricing model allows charging users based on specifi
 
 :::info How pay-per-event pricing works
 
-If you want more details about PPE pricing, please refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+If you want more details about PPE pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
 
 :::
 

sources/academy/platform/get_most_of_actors/store_basics/how_actor_monetization_works.md

@@ -35,7 +35,7 @@ Monetizing your Actor on the Apify platform involves several key steps:
 
 :::info Rental pricing details
 
-If you want more details about rental pricing, please refer to our [rental pricing documentation](/platform/actors/publishing/monetize/rental).
+If you want more details about rental pricing, refer to our [rental pricing documentation](/platform/actors/publishing/monetize/rental).
 
 :::
 
@@ -55,7 +55,7 @@ If you want more details about rental pricing, please refer to our [rental prici
 
 :::info Pay-per-result details
 
-If you want more details about PPR pricing, please refer to our [PPR documentation](/platform/actors/publishing/monetize/pay-per-result).
+If you want more details about PPR pricing, refer to our [PPR documentation](/platform/actors/publishing/monetize/pay-per-result).
 
 :::
 
@@ -87,7 +87,7 @@ If you want more details about PPR pricing, please refer to our [PPR documentati
 
 :::info Pay-per-event details
 
-If you want more details about PPE pricing, please refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
+If you want more details about PPE pricing, refer to our [PPE documentation](/platform/actors/publishing/monetize/pay-per-event).
 
 :::
 

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

@@ -148,7 +148,7 @@ One of the options to charge for the time spent on starting the Actor is to char
 
 We want to make it easier for Actor creators to stay competitive, but also help them to be profitable. Therefore, we have the Apify Actor synthetic start event `apify-actor-start`. This event is enabled by default for all new PPE Actors, and when you use it Apify will cover the compute unit cost of the first 5 seconds of every Actor run.
 
-The default price of the event is set intentionally low. This pricing means that the free 5 seconds of compute we provide costs us more than the revenue generated from the event. We've made this investment to **support our creator community** by reducing your startup costs while keeping your Actors competitively priced for users.
+The default price of the event is set intentionally low. This pricing means that the free 5 seconds of compute we provide costs us more than the revenue generated from the event. We've made this investment to _support our creator community_ by reducing your startup costs while keeping your Actors competitively priced for users.
 
 #### How the synthetic start event works
 
@@ -171,13 +171,13 @@ For new Actors, this event is added automatically as you can see on the followin
 
 #### Synthetic start event for existing Actors
 
-If you have existing Actors, you can add this event manually in Apify Console in the Publication tab.
+If you have existing Actors, you can add this event manually in Apify Console in the **Publication** tab.
 
 #### Synthetic start event for Actors with start event
 
 Your Actor might already have a start event defined, such as `actor-start` or another variant of the event name. In this case, you can choose whether to use the synthetic start event or keep the existing start event.
 
-If you want to use the synthetic start event, remove the existing start event from your Actor and add the synthetic start event in Apify Console in the Publication tab.
+If you want to use the synthetic start event, remove the existing start event from your Actor and add the synthetic start event in Apify Console in the **Publication** tab.
 
 ### Set memory limits
 
@@ -320,8 +320,8 @@ You create a social media monitoring Actor with the following pricing:
 
 You have two main strategies for charging AI-related operations:
 
-1. **Fixed event pricing** (like `sentiment-analysis` above): Charge a fixed amount per operation, regardless of actual LLM costs
-2. **Usage-based pricing**: Use events like `llm-token` that charge based on actual LLM usage costs
+1. _Fixed event pricing_ (like `sentiment-analysis` above): Charge a fixed amount per operation, regardless of actual LLM costs
+2. _Usage-based pricing_: Use events like `llm-token` that charge based on actual LLM usage costs
 
 Fixed pricing is simpler for users to predict, while usage-based pricing more accurately reflects your actual costs.
 
@@ -392,15 +392,15 @@ Fixed pricing is simpler for users to predict, while usage-based pricing more ac
   </tbody>
 </table>
 
-Your profit and costs are computed **only from the first two users** since they are on Apify paid plans.
+Your profit and costs are computed _only from the first two users_ since they are on Apify paid plans.
 
 The platform usage costs are just examples, but you can see the actual costs in the [Computing your costs for PPE and PPR Actors](/platform/actors/publishing/monetize/pricing-and-costs#computing-your-costs-for-ppe-and-ppr-actors) section.
 
 ### Revenue breakdown
 
-- **Revenue (paid users only)**: $20.05 + $11.02 = **$31.07**
-- **Platform cost (paid users only)**: $2.50 + $1.50 = **$4.00**
-- **Profit**: 0.8 × $31.07 − $4.00 = **$20.86**
+- _Revenue (paid users only): $20.05 + $11.02 = $31.07_
+- _Platform cost (paid users only): $2.50 + $1.50 = $4.00_
+- _Profit: 0.8 × $31.07 − $4.00 = $20.86_
 
 ## Event names
 

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

@@ -35,7 +35,7 @@ PPR charges based on the number of results produced. PPE lets you define pricing
 
 :::info Learn more about PPE
 
-If you want to learn more about PPE, please refer to the [Pay per event](/platform/actors/publishing/monetize/pay-per-event) section.
+If you want to learn more about PPE, refer to the [Pay per event](/platform/actors/publishing/monetize/pay-per-event) section.
 
 :::
 
@@ -260,15 +260,15 @@ You make your Actor PPR and set the price to be _$1/1,000 results_. During the f
   </tbody>
 </table>
 
-Your profit and costs are computed **only from the first two users** since they are on Apify paid plans.
+Your profit and costs are computed _only from the first two users_ since they are on Apify paid plans.
 
 The platform usage costs are just examples, but you can see the actual costs in the [Computing your costs for PPE and PPR Actors](/platform/actors/publishing/monetize/pricing-and-costs#computing-your-costs-for-ppe-and-ppr-actors) section.
 
 ### Revenue breakdown
 
-- **Revenue (paid users only)**: $50.00 + $20.00 = **$70.00**
-- **Platform cost (paid users only)**: $5.00 + $2.00 = **$7.00**
-- **Profit**: 0.8 × $70.00 − $7.00 = **$49.00**
+- _Revenue (paid users only): $50.00 + $20.00 = $70.00_
+- _Platform cost (paid users only): $5.00 + $2.00 = $7.00_
+- _Profit: 0.8 × $70.00 − $7.00 = $49.00_
 
 ## Next steps