docs: Restructure documentation with separate introduction section (#771)

## Summary

Re-applies the documentation restructuring from #740 (which was reverted
in #763).

- Split the monolithic overview page into three focused pages:
Introduction, Installation, and Quick start
- Reorganized documentation structure by moving webserver guide from
concepts to guides section
- Renumbered concept pages to maintain proper ordering after moving
webserver content
- Updated sidebar configuration to create a dedicated Introduction
category
- Updated redirect on landing page to point to `/docs/introduction`

Author: patrikbraborec

README.md

@@ -159,7 +159,7 @@ To create and run Actors through Apify Console,
 see the [Console documentation](https://docs.apify.com/academy/getting-started/creating-actors#choose-your-template).
 
 To create and run Python Actors locally, check the documentation for
-[how to create and run Python Actors locally](https://docs.apify.com/sdk/python/docs/overview/running-locally).
+[how to create and run Python Actors locally](https://docs.apify.com/sdk/python/docs/quick-start).
 
 ## Guides
 

docs/01_overview/code/01_introduction.py …/01_introduction/code/01_introduction.pydocs/01_overview/code/01_introduction.py renamed to docs/01_introduction/code/01_introduction.py docs/01_overview/code/01_introduction.py renamed to docs/01_introduction/code/01_introduction.py

@@ -0,0 +1,48 @@
+---
+id: introduction
+title: Overview
+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. It provides useful features like Actor lifecycle management, local storage emulation, and Actor event handling.
+
+```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 })
+```
+
+## 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
+
+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 for a deeper understanding of the SDK's features and best practices.
+
+## Installation
+
+The Apify SDK for Python requires Python version 3.10 or above. It 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
+```
+
+:::note API client alternative
+
+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.
+
+:::

…verview/code/actor_structure/__init__.py …duction/code/actor_structure/__init__.pydocs/01_overview/code/actor_structure/__init__.py renamed to docs/01_introduction/code/actor_structure/__init__.py docs/01_overview/code/actor_structure/__init__.py renamed to docs/01_introduction/code/actor_structure/__init__.py

@@ -1,47 +1,19 @@
 ---
-title: Overview
-sidebar_label: Overview
+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.'
+---
+
+Learn how to create and run Actors using the Apify SDK for Python.
+
 ---
 
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 import CodeBlock from '@theme/CodeBlock';
 
-The Apify SDK for Python is the official library for creating [Apify Actors](https://docs.apify.com/platform/actors) in Python.
-
-```py
-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 })
-```
-
-## Requirements
-
-The Apify SDK requires Python version 3.10 or above to run Python Actors locally.
-
-## Installation
-
-The Apify Python SDK is available as [`apify`](https://pypi.org/project/apify/) package on PyPi. To install it, run:
-
-```bash
-pip install apify
-```
-
-When you create an Actor using the Apify CLI, the Apify SDK for Python is installed for you automatically.
-
-If you are not developing Apify Actors and you just need to access the Apify API from Python,
-consider using the [Apify API client for Python](/api/client/python) directly.
-
-## Quick start
-
-### Creating Actors
+## Step 1: Create Actors
 
 To create and run Actors in Apify Console, refer to the [Console documentation](/platform/actors/development/quick-start/web-ide).
 
@@ -55,9 +27,9 @@ apify create my-first-actor --template python-start
 
 This will create a new folder called `my-first-actor`, download and extract the "Getting started with Python" Actor template there, create a virtual environment in `my-first-actor/.venv`, and install the Actor dependencies in it.
 
-![actor create command run](../01_overview/images/apify-create.gif)
+![actor create command run](./images/apify-create.gif)
 
-#### Running the Actor
+## Step 2: Run Actors
 
 To run the Actor, you can use the [`apify run` command](/cli/docs/reference#apify-run):
 
@@ -74,7 +46,7 @@ This command:
 
 The Actor input, for example, will be in `storage/key_value_stores/default/INPUT.json`.
 
-## Actor structure
+## Step 3: Understand Actor structure
 
 All Python Actor templates follow the same structure.
 
@@ -122,31 +94,6 @@ asyncio.run(main())`
 If you want to modify the Actor structure, you need to make sure that your Actor is executable as a module, via `python -m src`, as that is the command started by `apify run` in the Apify CLI.
 We recommend keeping the entrypoint for the Actor in the `src/__main__.py` file.
 
-## Adding dependencies
-
-First, add the dependencies in the [`requirements.txt`](https://pip.pypa.io/en/stable/reference/requirements-file-format/) file in the Actor source folder.
-
-Then activate the virtual environment in `.venv`:
-
-<Tabs groupId="operating-systems">
-    <TabItem value="unix" label="Linux / macOS" default>
-        <CodeBlock language="bash">{
-`source .venv/bin/activate`
-        }</CodeBlock>
-    </TabItem>
-    <TabItem value="win" label="Windows">
-        <CodeBlock language="powershell">{
-`.venv\\Scripts\\activate`
-        }</CodeBlock>
-    </TabItem>
-</Tabs>
-
-Finally, install the dependencies:
-
-```bash
-python -m pip install -r requirements.txt
-```
-
 ## Next steps
 
 ### Guides

…verview/code/actor_structure/__main__.py …duction/code/actor_structure/__main__.pydocs/01_overview/code/actor_structure/__main__.py renamed to docs/01_introduction/code/actor_structure/__main__.py docs/01_overview/code/actor_structure/__main__.py renamed to docs/01_introduction/code/actor_structure/__main__.py

@@ -5,10 +5,10 @@ title: Logging
 
 import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
 
-import LogConfigExample from '!!raw-loader!roa-loader!./code/10_log_config.py';
-import LoggerUsageExample from '!!raw-loader!roa-loader!./code/10_logger_usage.py';
-import RedirectLog from '!!raw-loader!roa-loader!./code/10_redirect_log.py';
-import RedirectLogExistingRun from '!!raw-loader!roa-loader!./code/10_redirect_log_existing_run.py';
+import LogConfigExample from '!!raw-loader!roa-loader!./code/09_log_config.py';
+import LoggerUsageExample from '!!raw-loader!roa-loader!./code/09_logger_usage.py';
+import RedirectLog from '!!raw-loader!roa-loader!./code/09_redirect_log.py';
+import RedirectLogExistingRun from '!!raw-loader!roa-loader!./code/09_redirect_log_existing_run.py';
 
 The Apify SDK is logging useful information through the [`logging`](https://docs.python.org/3/library/logging.html) module from Python's standard library, into the logger with the name `apify`.