scrapinghub · AdrianAtZyte · Jul 23, 2026
diff --git a/docs/conf.py b/docs/conf.py
@@ -42,6 +42,7 @@
 extensions = ['sphinx_scrapy', 'sphinx_reredirects']
 
 redirects = {
+    "quickstart": "intro/install.html",
     "client/overview": "../use/overview.html",
     "client/apidocs": "../ref/apidocs.html",
 }

diff --git a/docs/index.rst b/docs/index.rst
@@ -10,7 +10,8 @@ The ``scrapinghub`` is a Python library for communicating with the `Scrapinghub
    :caption: Getting started
    :maxdepth: 1
 
-   quickstart
+   intro/install
+   intro/basic
 
 .. toctree::
    :caption: Usage

diff --git a/docs/quickstart.rst → docs/intro/basic.rst b/docs/quickstart.rst → docs/intro/basic.rst
@@ -1,27 +1,5 @@
-Quickstart
-==========
-
-Requirements
-------------
-
-* Python 3.10+
-
-
-Installation
-------------
-
-The quick way::
-
-    pip install scrapinghub
-
-It is recommended to install the library with `MessagePack`_ support,
-it provides better response time and improved bandwidth usage::
-
-    pip install scrapinghub[msgpack]
-
-
 Basic usage
------------
+===========
 
 Instantiate a new client with your Scrapy Cloud API key::
 
@@ -86,6 +64,3 @@ Access your job's output data::
 
 Checkout all the other features in :ref:`overview` or in the more
 detailed :ref:`api-reference`.
-
-
-.. _MessagePack: https://en.wikipedia.org/wiki/MessagePack
diff --git a/docs/intro/install.rst b/docs/intro/install.rst
@@ -0,0 +1,23 @@
+Installation
+============
+
+Requirements
+------------
+
+* Python 3.10+
+
+
+Installing scrapinghub
+----------------------
+
+The quick way::
+
+    pip install scrapinghub
+
+It is recommended to install the library with `MessagePack`_ support,
+it provides better response time and improved bandwidth usage::
+
+    pip install scrapinghub[msgpack]
+
+
+.. _MessagePack: https://en.wikipedia.org/wiki/MessagePack