docs: adding a new Pick Your Path section to the overview page

2026-02-14 00:43:05 +02:00
parent c6a662eb38
commit 6a0c323482
2 changed files with 15 additions and 1 deletions
@@ -1,3 +1,17 @@
+## Pick Your Path
+
+Not sure where to start? Pick the path that matches what you're trying to do:
+
+| I want to... | Start here |
+|:---|:---|
+| **Parse HTML** I already have | [Querying elements](parsing/selection.md) — CSS, XPath, and text-based selection |
+| **Quickly scrape a page** and prototype | Pick a [fetcher](fetching/choosing.md) and test right away, or launch the [interactive shell](cli/interactive-shell.md) |
+| **Build a crawler** that scales | [Spiders](spiders/getting-started.md) — concurrent, multi-session crawls with pause/resume |
+| **Scrape without writing code** | [CLI extract commands](cli/extract-commands.md) or hook up the [MCP server](ai/mcp-server.md) to your favourite AI tool |
+| **Migrate** from another library | [From BeautifulSoup](tutorials/migrating_from_beautifulsoup.md) or [Scrapy comparison](spiders/architecture.md#comparison-with-scrapy) |
+
+---
+
 We will start by quickly reviewing the parsing capabilities. Then we will fetch websites using custom browsers, make requests, and parse the responses.

 Here's an HTML document generated by ChatGPT that we will be using as an example throughout this page: