Nest plugin development docs

3 files changed, 24 insertions, 3 deletions

diff --git a/docs/source/dev/formatters.rst b/docs/source/dev/formatters.rst
index 0b37abd..5307e75 100644
--- a/docs/source/dev/formatters.rst
+++ b/docs/source/dev/formatters.rst
@@ -1,3 +1,5 @@
+.. _formatting-plugins:
+
 ===========================================
  Developing a Formatting Plugin for Flake8
 ===========================================
diff --git a/docs/source/dev/index.rst b/docs/source/dev/index.rst
new file mode 100644
index 0000000..43f01c1
--- /dev/null
+++ b/docs/source/dev/index.rst
@@ -0,0 +1,17 @@
+============================
+ Writing Plugins for Flake8
+============================
+
+Since Flake8 2.0, the Flake8 tool has allowed for extensions and custom
+plugins. In Flake8 3.0, we're expanding that ability to customize and
+extend **and** we're attempting to thoroughly document it too. Some of the
+documentation in this section will reference third-party documentation
+in order to reduce duplication and to point you, the developer, towards
+the authoritative documentation for those pieces.
+
+.. toctree::
+    :maxdepth: 2
+
+    plugin_parameters
+    registering_plugins
+    formatters
diff --git a/docs/source/dev/plugin_parameters.rst b/docs/source/dev/plugin_parameters.rst
index 39db95e..9b074ec 100644
--- a/docs/source/dev/plugin_parameters.rst
+++ b/docs/source/dev/plugin_parameters.rst
@@ -1,6 +1,8 @@
-====================================
- Receiving Information For A Plugin
-====================================
+.. _plugin-parameters:
+
+==========================================
+ Receiving Information For A Check Plugin
+==========================================
 
 Plugins to Flake8 have a great deal of information that they can request from
 a :class:`~flake8.processor.FileProcessor` instance. Historically, Flake8 has