Revert "docs: Revert documentation restructure (#763)"

This reverts commit 2ed03ca.

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,45 @@
+---
+id: introduction
+title: Overview
+sidebar_label: 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 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
+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 })
+```
+
+## Features
+
+The Apify SDK for Python provides:
+
+- **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
+
+## Next steps
+
+- **[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

…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

@@ -0,0 +1,51 @@
+---
+title: Installation
+sidebar_label: Installation
+description: 'Learn how to install the Apify SDK for Python using pip and manage dependencies for your Actor projects.'
+---
+
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import CodeBlock from '@theme/CodeBlock';
+
+## 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.
+
+## 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
+```

…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

@@ -1,47 +1,18 @@
 ---
-title: Overview
-sidebar_label: Overview
+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: Creating Actors
 
 To create and run Actors in Apify Console, refer to the [Console documentation](/platform/actors/development/quick-start/web-ide).
 
@@ -55,9 +26,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: Running the Actor
 
 To run the Actor, you can use the [`apify run` command](/cli/docs/reference#apify-run):
 
@@ -74,7 +45,7 @@ This command:
 
 The Actor input, for example, will be in `storage/key_value_stores/default/INPUT.json`.
 
-## Actor structure
+## Step 3: Understanding Actor structure
 
 All Python Actor templates follow the same structure.
 
@@ -122,31 +93,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