Merge remote-tracking branch 'origin/master' into docs/changelog-v3-cleanup

# Conflicts:
#	CHANGELOG.md

Author: vdusek

CHANGELOG.md

@@ -2,9 +2,7 @@
 
 All notable changes to this project will be documented in this file.
 
-<!-- git-cliff-unreleased-start -->
-
-## 3.0.0 - **not yet released**
+## [3.0.0](https://github.com/apify/apify-client-python/releases/tag/v3.0.0) (2026-05-20)
 
 - Check out the [Upgrading guide](https://docs.apify.com/api/client/python/docs/upgrading/upgrading-to-v3) to ensure a smooth update.
 
@@ -42,8 +40,6 @@ All notable changes to this project will be documented in this file.
 
 - [**breaking**] Drop support for Python 3.10 ([#636](https://github.com/apify/apify-client-python/pull/636)) ([7895a4e](https://github.com/apify/apify-client-python/commit/7895a4e60145f490911044da4aa7e3c1c424d416)) by [@vdusek](https://github.com/vdusek)
 
-<!-- git-cliff-unreleased-end -->
-
 ## [2.5.1](https://github.com/apify/apify-client-python/releases/tag/v2.5.1) (2026-05-20)
 
 ### 🐛 Bug Fixes

pyproject.toml

@@ -4,7 +4,7 @@ build-backend = "hatchling.build"
 
 [project]
 name = "apify_client"
-version = "2.5.1"
+version = "3.0.0"
 description = "Apify API client for Python"
 authors = [{ name = "Apify Technologies s.r.o.", email = "support@apify.com" }]
 license = { file = "LICENSE" }

uv.lock

@@ -12,5 +12,5 @@ async def main() -> None:
         'some': 'input',
     }
 
-    # Start an Actor and waits for it to finish.
+    # Start an Actor and wait for it to finish.
     call_result = await actor_client.call(run_input=run_input)

website/versioned_docs/version-2.5/01_introduction/code/03_input_async.py

@@ -12,5 +12,5 @@ def main() -> None:
         'some': 'input',
     }
 
-    # Start an Actor and waits for it to finish.
+    # Start an Actor and wait for it to finish.
     call_result = actor_client.call(run_input=run_input)

website/versioned_docs/version-2.5/01_introduction/code/03_input_sync.py

@@ -1,9 +1,8 @@
 ---
 id: introduction
 title: Overview
-sidebar_label: Overview
 slug: /
-description: "The official Python library to access the Apify API, with automatic retries, async support, and comprehensive API coverage."
+description: The official Python library to access the Apify API, with automatic retries, async support, and comprehensive API coverage.
 ---
 
 import Tabs from '@theme/Tabs';
@@ -24,7 +23,7 @@ The client simplifies interaction with the Apify platform by providing:
 
 ## Prerequisites
 
-`apify-client` requires Python 3.10 or higher. Python is available for download on the [official website](https://www.python.org/downloads/). Check your current Python version by running:
+`apify-client` requires Python 3.11 or higher. Python is available for download on the [official website](https://www.python.org/downloads/). Check your current Python version by running:
 
 ```bash
 python --version
@@ -40,7 +39,7 @@ pip install apify-client
 
 ## Quick example
 
-Here's an example showing how to run an Actor and retrieve its results:
+The following example shows how to run an Actor and retrieve its results:
 
 <Tabs>
     <TabItem value="AsyncExample" label="Async client" default>

website/versioned_docs/version-2.5/01_introduction/index.mdx

@@ -1,8 +1,7 @@
 ---
 id: quick-start
 title: Quick start
-sidebar_label: Quick start
-description: "Get started with the Apify API client for Python by running an Actor and retrieving results from its dataset."
+description: Get started with the Apify API client for Python by running an Actor and retrieving results from its dataset.
 ---
 
 import Tabs from '@theme/Tabs';

website/versioned_docs/version-2.5/01_introduction/quick-start.mdx

@@ -1,6 +1,7 @@
 ---
 id: asyncio-support
 title: Asyncio support
+description: Use the async client for non-blocking API calls with Python asyncio.
 ---
 
 import Tabs from '@theme/Tabs';
@@ -10,10 +11,12 @@ import ApiLink from '@theme/ApiLink';
 
 import AsyncSupportExample from '!!raw-loader!./code/01_async_support.py';
 
-The package provides an asynchronous version of the client, <ApiLink to="class/ApifyClientAsync">`ApifyClientAsync`</ApiLink>, which allows you to interact with the Apify API using Python's standard async/await syntax. This enables you to perform non-blocking operations, see the Python [asyncio documentation](https://docs.python.org/3/library/asyncio-task.html) for more information.
+The package provides an asynchronous version of the client, <ApiLink to="class/ApifyClientAsync">`ApifyClientAsync`</ApiLink>, which allows you to interact with the Apify API using Python's standard async/await syntax. This enables you to perform non-blocking operations, see the Python [asyncio documentation](https://docs.python.org/3/library/asyncio-task.html) for more information. This is useful for applications that need to perform multiple API operations concurrently or integrate with other async frameworks.
 
-The following example demonstrates how to run an Actor asynchronously and stream its logs while it is running:
+The following example shows how to run an Actor asynchronously and stream its logs while it is running:
 
 <CodeBlock className="language-python">
     {AsyncSupportExample}
 </CodeBlock>
+
+For the full async client API, see the <ApiLink to="class/ApifyClientAsync">`ApifyClientAsync`</ApiLink> reference.

website/versioned_docs/version-2.5/02_concepts/01_async_support.mdx

@@ -1,6 +1,7 @@
 ---
 id: single-and-collection-clients
 title: Single and collection clients
+description: Understand the two types of resource clients, single-resource and collection clients.
 ---
 
 import Tabs from '@theme/Tabs';
@@ -14,7 +15,7 @@ import CollectionSyncExample from '!!raw-loader!./code/02_collection_sync.py';
 import SingleAsyncExample from '!!raw-loader!./code/02_single_async.py';
 import SingleSyncExample from '!!raw-loader!./code/02_single_sync.py';
 
-The Apify client interface is designed to be consistent and intuitive across all of its components. When you call specific methods on the main client, you create specialized clients to manage individual API resources. There are two main types of clients:
+The Apify client provides two types of resource clients: single-resource clients for managing an individual resource, and collection clients for listing or creating resources.
 
 - <ApiLink to="class/ActorClient">`ActorClient`</ApiLink> - Manages a single resource.
 - <ApiLink to="class/ActorCollectionClient">`ActorCollectionClient`</ApiLink> - Manages a collection of resources.

website/versioned_docs/version-2.5/02_concepts/02_single_collection_clients.mdx

@@ -1,6 +1,7 @@
 ---
 id: nested-clients
 title: Nested clients
+description: Access related resources directly through nested client methods.
 ---
 
 import Tabs from '@theme/Tabs';
@@ -12,7 +13,7 @@ import ApiLink from '@theme/ApiLink';
 import NestedAsyncExample from '!!raw-loader!./code/03_nested_async.py';
 import NestedSyncExample from '!!raw-loader!./code/03_nested_sync.py';
 
-In some cases, the Apify client provides nested clients to simplify working with related collections. For example, you can easily manage the runs of a specific Actor without having to construct multiple endpoints or client instances manually.
+Nested clients let you access related resources directly from a parent resource client, without manually constructing new client instances.
 
 <Tabs>
     <TabItem value="AsyncExample" label="Async client" default>