@@ -167,7 +167,7 @@ if __name__ == '__main__':
 
 ### More examples
 
-Explore our [Examples](https://crawlee.dev/python/docs/examples) page in the Crawlee documentation for a wide range of additional use cases and demonstrations.
+Explore the [Guides](https://crawlee.dev/python/docs/guides) section of the Crawlee documentation for a wide range of additional use cases and demonstrations.
 
 ## Features
 
 
@@ -0,0 +1,134 @@
+---
+id: quick-start
+title: Quick start
+description: Build and run your first Crawlee crawler in a few minutes, and pick the crawler type that fits your project.
+---
+
+import ApiLink from '@site/src/components/ApiLink';
+import Tabs from '@theme/Tabs';
+import TabItem from '@theme/TabItem';
+import CodeBlock from '@theme/CodeBlock';
+import RunnableCodeBlock from '@site/src/components/RunnableCodeBlock';
+
+import BeautifulsoupCrawlerExample from '!!raw-loader!roa-loader!./code_examples/beautifulsoup_crawler_example.py';
+import ParselCrawlerExample from '!!raw-loader!roa-loader!./code_examples/parsel_crawler_example.py';
+import PlaywrightCrawlerExample from '!!raw-loader!roa-loader!./code_examples/playwright_crawler_example.py';
+
+import PlaywrightCrawlerHeadfulExample from '!!raw-loader!./code_examples/playwright_crawler_headful_example.py';
+
+This page gets you from installation to a running crawler in a few minutes. To build a complete scraper step by step, follow the [Introduction](./introduction).
+
+## Choose your crawler
+
+Crawlee's main crawler classes are <ApiLink to="class/BeautifulSoupCrawler">`BeautifulSoupCrawler`</ApiLink>, <ApiLink to="class/ParselCrawler">`ParselCrawler`</ApiLink>, and <ApiLink to="class/PlaywrightCrawler">`PlaywrightCrawler`</ApiLink>. All crawlers share the same interface, so you can switch between them without rewriting your handlers.
+
+:::caution Minimum Python version
+
+Crawlee requires Python 3.10 or higher.
+
+:::
+
+### BeautifulSoupCrawler
+
+The <ApiLink to="class/BeautifulSoupCrawler">`BeautifulSoupCrawler`</ApiLink> is a plain HTTP crawler that parses HTML using the well-known [BeautifulSoup](https://pypi.org/project/beautifulsoup4/) library. It fetches pages with an HTTP client that mimics a browser. It's fast and light, but it can't render JavaScript.
+
+### ParselCrawler
+
+The <ApiLink to="class/ParselCrawler">`ParselCrawler`</ApiLink> is similar to the <ApiLink to="class/BeautifulSoupCrawler">`BeautifulSoupCrawler`</ApiLink> but uses the [Parsel](https://pypi.org/project/parsel/) library for HTML parsing. Parsel extracts data from HTML with CSS selectors and XPath, and it's the selector library [Scrapy](https://scrapy.org/) uses. Like the <ApiLink to="class/BeautifulSoupCrawler">`BeautifulSoupCrawler`</ApiLink>, the <ApiLink to="class/ParselCrawler">`ParselCrawler`</ApiLink> can't render JavaScript.
+
+### PlaywrightCrawler
+
+The <ApiLink to="class/PlaywrightCrawler">`PlaywrightCrawler`</ApiLink> uses a headless browser controlled by the [Playwright](https://playwright.dev/) library. It can drive Chromium, Firefox, and WebKit. Choose it when the target pages render their content with JavaScript.
+
+## Installation
+
+Crawlee is available as the [`crawlee`](https://pypi.org/project/crawlee/) package on PyPI. The package includes the core functionality, and additional features are available as optional extras to keep dependencies small.
+
+To install Crawlee with all extras using [pip](https://pip.pypa.io/en/stable/), run:
+
+```sh
+python -m pip install 'crawlee[all]'
+```
+
+Verify that Crawlee is successfully installed:
+
+```sh
+python -c 'import crawlee; print(crawlee.__version__)'
+```
+
+If you plan to use the <ApiLink to="class/PlaywrightCrawler">`PlaywrightCrawler`</ApiLink>, also install the Playwright browser binaries:
+
+```sh
+playwright install
+```
+
+For detailed installation instructions, see [Setting up](./introduction/setting-up).
+
+## Crawling
+
+Run the following example to perform a recursive crawl of the Crawlee website using the selected crawler.
+
+<Tabs groupId="quickStart">
+    <TabItem value="BeautifulSoupCrawler" label="BeautifulSoupCrawler" default>
+        <RunnableCodeBlock className="language-python" language="python">
+            {BeautifulsoupCrawlerExample}
+        </RunnableCodeBlock>
+    </TabItem>
+    <TabItem value="ParselCrawler" label="ParselCrawler">
+        <RunnableCodeBlock className="language-python" language="python">
+            {ParselCrawlerExample}
+        </RunnableCodeBlock>
+    </TabItem>
+    <TabItem value="PlaywrightCrawler" label="PlaywrightCrawler">
+        <RunnableCodeBlock className="language-python" language="python">
+            {PlaywrightCrawlerExample}
+        </RunnableCodeBlock>
+    </TabItem>
+</Tabs>
+
+When you run the example, the crawler logs its progress to your terminal.
+
+{/*TODO: improve the logging and add here a sample*/}
+
+## Running headful browser
+
+By default, browsers controlled by Playwright run in headless mode, without a visible window. During development, it helps to run the browser in headful mode and watch what it does. You can also switch from the default Chromium browser to Firefox or WebKit.
+
+<CodeBlock language="python">
+    {PlaywrightCrawlerHeadfulExample}
+</CodeBlock>
+
+When you run the example, a browser window opens and navigates through the Crawlee website.
+
+{/*TODO: add video example*/}
+
+## Results
+
+By default, Crawlee stores data in the `./storage` directory within your current working directory. The crawl results are saved as JSON files under `./storage/datasets/default/`.
+
+To view the results, use the `cat` command:
+
+```sh
+cat ./storage/datasets/default/000000001.json
+```
+
+The JSON file contains data similar to the following:
+
+```json
+{
+    "url": "https://crawlee.dev/",
+    "title": "Crawlee · Build reliable crawlers. Fast. | Crawlee"
+}
+```
+
+:::tip
+
+To change the storage directory, set the `CRAWLEE_STORAGE_DIR` environment variable to your preferred path.
+
+:::
+
+## Next steps
+
+- To build a complete scraper for a real website step by step, follow the [Introduction](./introduction).
+- To learn how crawlers, requests, storages, and other parts of Crawlee work, read the [Concepts](./concepts).
+- For solutions to specific tasks, see the [Guides](./guides).
@@ -1,14 +1,15 @@
 ---
 id: setting-up
 title: Setting up
+description: How to install Crawlee, set up your environment, and bootstrap a new project.
 ---
 
 import ApiLink from '@site/src/components/ApiLink';
 import CodeBlock from '@theme/CodeBlock';
 import Tabs from '@theme/Tabs';
 import TabItem from '@theme/TabItem';
 
-This guide will help you get started with Crawlee by setting it up on your computer. Follow the steps below to ensure a smooth installation process.
+This tutorial takes you from the simplest crawler, which prints a page title, to a scraper that crawls a real website and extracts product data. The first step is setting up Crawlee on your computer.
 
 ## Prerequisites
 
 
@@ -1,6 +1,7 @@
 ---
 id: first-crawler
 title: First crawler
+description: Build your first Crawlee crawler - set up a request queue, write a request handler, and crawl your first page.
 ---
 
 import ApiLink from '@site/src/components/ApiLink';
 
@@ -1,6 +1,7 @@
 ---
 id: adding-more-urls
 title: Adding more URLs
+description: Grow the crawl by discovering and enqueuing new links, with filtering and deduplication handled for you.
 ---
 
 import ApiLink from '@site/src/components/ApiLink';
 
@@ -1,6 +1,7 @@
 ---
 id: real-world-project
 title: Real-world project
+description: Plan a real scraping project - choose the data to collect and analyze the target website before writing code.
 ---
 
 import ApiLink from '@site/src/components/ApiLink';