diff --git a/docs/contributing.rst b/docs/contributing.rst
index 161523631..9166d7d8e 100644
--- a/docs/contributing.rst
+++ b/docs/contributing.rst
@@ -214,6 +214,26 @@ plugins implement the `~letsencrypt.interfaces.IDisplay`
 interface.
 
 
+Writing your own plugin
+=======================
+
+Let's Encrypt client supports dynamic discovery of plugins through the
+`setuptools entry points`_. This way you can, for example, create a
+custom implementation of `~letsencrypt.interfaces.IAuthenticator` or
+the `~letsencrypt.interfaces.IInstaller` without having to merge it
+with the core upstream source code. An example is provided in
+``examples/plugins/`` directory.
+
+.. warning:: Please be aware though that as this client is still in a
+   developer-preview stage, the API may undergo a few changes. If you
+   believe the plugin will be beneficial to the community, please
+   consider submitting a pull request to the repo and we will update
+   it with any necessary API changes.
+
+.. _`setuptools entry points`:
+  https://pythonhosted.org/setuptools/setuptools.html#dynamic-discovery-of-services-and-plugins
+
+
 .. _coding-style:
 
 Coding style
diff --git a/docs/index.rst b/docs/index.rst
index a7df1fb0f..68289d760 100644
--- a/docs/index.rst
+++ b/docs/index.rst
@@ -8,7 +8,6 @@ Welcome to the Let's Encrypt client documentation!
    using
    contributing
    packaging
-   plugins
 
 .. toctree::
    :maxdepth: 1
diff --git a/docs/plugins.rst b/docs/plugins.rst
deleted file mode 100644
index 33d63e84f..000000000
--- a/docs/plugins.rst
+++ /dev/null
@@ -1,19 +0,0 @@
-=======
-Plugins
-=======
-
-Let's Encrypt client supports dynamic discovery of plugins through the
-`setuptools entry points`_. This way you can, for example, create a
-custom implementation of `~letsencrypt.interfaces.IAuthenticator` or
-the `~letsencrypt.interfaces.IInstaller` without having to merge it
-with the core upstream source code. An example is provided in
-``examples/plugins/`` directory.
-
-.. warning:: Please be aware though that as this client is still in a
-   developer-preview stage, the API may undergo a few changes. If you
-   believe the plugin will be beneficial to the community, please
-   consider submitting a pull request to the repo and we will update
-   it with any necessary API changes.
-
-.. _`setuptools entry points`:
-  https://pythonhosted.org/setuptools/setuptools.html#dynamic-discovery-of-services-and-plugins