diff --git a/docs/index.rst b/docs/index.rst
index de3e015d55d..4097aba3153 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -150,7 +150,7 @@ Solving specific problems
    topics/leaks
    topics/images
    topics/ubuntu
-   topics/scrapyd
+   topics/deployment
    topics/autothrottle
    topics/benchmarking
    topics/jobs
@@ -186,7 +186,7 @@ Solving specific problems
 :doc:`topics/ubuntu`
     Install latest Scrapy packages easily on Ubuntu
 
-:doc:`topics/scrapyd`
+:doc:`topics/deployment`
     Deploying your Scrapy project in production.
 
 :doc:`topics/autothrottle`
diff --git a/docs/topics/deployment.rst b/docs/topics/deployment.rst
new file mode 100644
index 00000000000..8f8c55c2ff1
--- /dev/null
+++ b/docs/topics/deployment.rst
@@ -0,0 +1,29 @@
+.. _topics-deployment:
+
+==========
+Deployment
+==========
+
+The recommended way to deploy Scrapy projects to a server is through `Scrapyd`_.
+
+.. _Scrapyd: /~https://github.com/scrapy/scrapyd
+
+Deploying to a Scrapyd Server
+=============================
+
+You can deploy to a Scrapyd server using the `Scrapyd client </~https://github.com/scrapy/scrapyd-client>`_. You can add targets to your ``scrapy.cfg`` file which can be deployed to using the ``scrapyd-deploy`` command.
+
+The basic syntax is as follows:
+
+    scrapyd-deploy <target> -p <project>
+
+For more information please refer to the `Deploying your project`_ section.
+
+.. _Deploying your project: https://scrapyd.readthedocs.org/en/latest/deploy.html
+
+Deploying to Scrapinghub
+========================
+
+You can deploy to Scrapinghub using Scrapinghub's command line client, `shub`_. The configuration is read from the ``scrapy.cfg`` file just like ``scrapyd-deploy``.
+
+.. _shub: /~https://github.com/scrapinghub/shub