docs: Restructure introduction section into a streamlined overview

Consolidate the introduction section by merging installation info into the
overview page, removing the separate installation page, and flattening the
sidebar navigation. Update slugs and redirect paths to use /overview.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: patrikbraborec

docs/01_introduction/index.mdx

@@ -1,45 +1,44 @@
 ---
 id: introduction
-title: Overview
+title: Apify SDK for Python
 sidebar_label: Overview
+slug: /overview
 description: 'The official library for creating Apify Actors in Python, providing tools for web scraping, automation, and data storage integration.'
 ---
 
-The Apify SDK for Python is the official library for creating [Apify Actors](https://docs.apify.com/platform/actors) in Python.
+The Apify SDK for Python is the official library for creating [Apify Actors](https://docs.apify.com/platform/actors) using Python. It provides useful features like Actor lifecycle management, local storage emulation, and Actor event handling.
 
-It provides tools and classes for web scraping and automation, allowing you to manage Actor lifecycles, handle data storage, work with proxies, and integrate with popular Python libraries.
-
-## Example
-
-Here's a simple example of an Actor that scrapes a web page and stores the result:
-
-```py
+```python
 from apify import Actor
-from bs4 import BeautifulSoup
-import requests
 
 async def main():
     async with Actor:
-        input = await Actor.get_input()
-        response = requests.get(input['url'])
-        soup = BeautifulSoup(response.content, 'html.parser')
-        await Actor.push_data({ 'url': input['url'], 'title': soup.title.string })
+        actor_input = await Actor.get_input()
+        print(actor_input)
 ```
 
-## Features
+## What are Actors
+
+Actors are serverless cloud programs capable of performing tasks in a web browser, similar to what a human can do. These tasks can range from simple operations, such as filling out forms or unsubscribing from services, to complex jobs like scraping and processing large numbers of web pages.
+
+Actors can be executed locally or on the [Apify platform](https://docs.apify.com/platform). The Apify platform lets you run Actors at scale and provides features for monitoring, scheduling, publishing, and monetizing them.
+
+## Quick start
 
-The Apify SDK for Python provides:
+To create and run Actors using Apify Console, check out [Apify Console documentation](https://docs.apify.com/platform/console). For creating and running Python Actors locally, refer to the [quick start guide](./quick-start).
+
+Explore the Guides section in the sidebar to see more of the SDK in action and for a deeper understanding of the SDK's features and best practices.
+
+## Installation
+
+The Apify SDK for Python is typically installed when you create a new Actor project using the [Apify CLI](https://docs.apify.com/cli). To install it manually in an existing project, use:
+
+```bash
+pip install apify
+```
 
-- **Actor lifecycle management** - Handle initialization, teardown, and graceful shutdowns
-- **Storage management** - Work with Datasets, Key-Value Stores, and Request Queues
-- **Event handling** - Respond to Actor events like migration, abort, and system info
-- **Proxy management** - Rotate and manage proxies for web scraping
-- **Platform integration** - Interact with other Actors, webhooks, and the Apify API
-- **Framework compatibility** - Integrate with BeautifulSoup, Playwright, Selenium, Scrapy, and Crawlee
+:::note API client alternative
 
-## Next steps
+If you need to interact with the Apify API programmatically without creating Actors, use the [Apify API client for Python](https://docs.apify.com/api/client/python) instead.
 
-- **[Installation](./installation)** - Install the SDK and set up your development environment
-- **[Quick start](./quick-start)** - Create and run your first Actor
-- **[Concepts](../concepts/actor-lifecycle)** - Learn about core SDK concepts
-- **[Guides](../guides/beautiful-soup)** - See how to integrate with popular libraries
+:::

docs/01_introduction/installation.mdx

@@ -1,4 +1,5 @@
 ---
+id: quick-start
 title: Quick start
 sidebar_label: Quick start
 description: 'Get started with the Apify SDK for Python by creating your first Actor and learning the basics.'

docs/01_introduction/quick-start.mdx

@@ -56,7 +56,7 @@ scrapy = ["scrapy>=2.11.0"]
 "Apify Homepage" = "https://apify.com"
 "Changelog" = "https://docs.apify.com/sdk/python/docs/changelog"
 "Discord" = "https://discord.com/invite/jyEM2PRvMU"
-"Documentation" = "https://docs.apify.com/sdk/python/docs/introduction"
+"Documentation" = "https://docs.apify.com/sdk/python/docs/overview"
 "Homepage" = "https://docs.apify.com/sdk/python/"
 "Issue Tracker" = "https://github.com/apify/apify-sdk-python/issues"
 "Release Notes" = "https://docs.apify.com/sdk/python/docs/upgrading/upgrading-to-v2"

pyproject.toml

@@ -1,15 +1,12 @@
 module.exports = {
     sidebar: [
         {
-            type: 'category',
-            label: 'Introduction',
-            collapsed: false,
-            items: [
-                {
-                    type: 'autogenerated',
-                    dirName: '01_introduction',
-                },
-            ],
+            type: 'doc',
+            id: 'introduction/introduction',
+        },
+        {
+            type: 'doc',
+            id: 'introduction/quick-start',
         },
         {
             type: 'category',

website/sidebars.js

@@ -5,7 +5,7 @@ export default function Home() {
     const history = useHistory();
 
     useEffect(() => {
-        history.replace('/sdk/python/docs/introduction');
+        history.replace('/sdk/python/docs/overview');
     }, [history]);
 
     return null;