scrapinghub · AdrianAtZyte · Jul 23, 2026 · Jun 25, 2026
diff --git a/docs/conf.py b/docs/conf.py
@@ -39,7 +39,12 @@
 # Add any Sphinx extension module names here, as strings. They can be
 # extensions coming with Sphinx (named 'sphinx.ext.*') or your custom
 # ones.
-extensions = ['sphinx_scrapy']
+extensions = ['sphinx_scrapy', 'sphinx_reredirects']
+
+redirects = {
+    "client/overview": "../use/overview.html",
+    "client/apidocs": "../ref/apidocs.html",
+}
 
 # Add any paths that contain templates here, relative to this directory.
 templates_path = ['_templates']

diff --git a/docs/index.rst b/docs/index.rst
@@ -16,13 +16,13 @@ The ``scrapinghub`` is a Python library for communicating with the `Scrapinghub
    :caption: Usage
    :maxdepth: 1
 
-   client/overview
+   use/overview
 
 .. toctree::
    :caption: Reference
    :maxdepth: 1
 
-   client/apidocs
+   ref/apidocs
 
 .. toctree::
    :caption: Legacy

diff --git a/docs/quickstart.rst b/docs/quickstart.rst
@@ -60,8 +60,8 @@ Access your job's output data::
     }
     ...
 
-Checkout all the other features in :doc:`client/overview` or in the more
-detailed :doc:`client/apidocs`.
+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/client/apidocs.rst → docs/ref/apidocs.rst b/docs/client/apidocs.rst → docs/ref/apidocs.rst
@@ -1,3 +1,5 @@
+.. _api-reference:
+
 API Reference
 =============
 

diff --git a/docs/requirements.in b/docs/requirements.in
@@ -1,2 +1,3 @@
+sphinx-reredirects
 sphinx-rtd-theme
 sphinx-scrapy @ git+https://github.com/scrapy/sphinx-scrapy.git@0.7.1
diff --git a/docs/requirements.txt b/docs/requirements.txt
@@ -38,6 +38,7 @@ sphinx==9.1.0
     #   sphinx-copybutton
     #   sphinx-llms-txt
     #   sphinx-markdown-builder
+    #   sphinx-reredirects
     #   sphinx-rtd-theme
     #   sphinx-scrapy
     #   sphinxcontrib-jquery
@@ -47,6 +48,8 @@ sphinx-llms-txt @ git+https://github.com/zytedata/sphinx-llms-txt.git@5e8866cb0c
     # via sphinx-scrapy
 sphinx-markdown-builder @ git+https://github.com/zytedata/sphinx-markdown-builder.git@ac9f8babfe622e4300099ab44b96d9d9228e742e
     # via sphinx-scrapy
+sphinx-reredirects==1.1.0
+    # via -r requirements.in
 sphinx-rtd-theme==3.1.0
     # via -r requirements.in
 sphinx-scrapy @ git+https://github.com/scrapy/sphinx-scrapy.git@2b5f6c7de64c8317cb771fdeb2e5020d1c9c9dcf

diff --git a/docs/client/overview.rst → docs/use/overview.rst b/docs/client/overview.rst → docs/use/overview.rst
@@ -1,3 +1,5 @@
+.. _overview:
+
 Overview
 ========