Nest plugin development docs

docs/source/dev/formatters.rst

@@ -1,3 +1,5 @@
+.. _formatting-plugins:
+
 ===========================================
  Developing a Formatting Plugin for Flake8
 ===========================================

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

docs/source/dev/plugin_parameters.rst

@@ -1,6 +1,8 @@
-====================================
+.. _plugin-parameters:
- Receiving Information For A Plugin
+
-====================================
+==========================================
+ 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

docs/source/index.rst

@@ -18,9 +18,7 @@ Plugin Developer Guide
 .. toctree::
     :maxdepth: 2
 
-    dev/formatters
+    dev/index
-    dev/plugin_parameters
-    dev/registering_plugins
 
 Developer Guide
 ---------------