Created a new section of the documentation pertaining to development.

--HG--
extra : rebase_source : 4d756b98daa068d888074b53f5708c1245fa70ba

4 files changed, 40 insertions, 20 deletions

diff --git a/docs/development.txt b/docs/development.txt
new file mode 100644
index 00000000..ba927c73
--- /dev/null
+++ b/docs/development.txt
@@ -0,0 +1,35 @@
+-------------------------
+Development on Setuptools
+-------------------------
+
+Setuptools is maintained by the Python community under the Python Packaging
+Authority (PyPA) and led by Jason R. Coombs.
+
+This document describes the process by which Setuptools is developed.
+This document assumes the reader has some passing familiarity with
+*using* setuptools, the ``pkg_resources`` module, and EasyInstall.  It
+does not attempt to explain basic concepts like inter-project
+dependencies, nor does it contain detailed lexical syntax for most
+file formats.  Neither does it explain concepts like "namespace
+packages" or "resources" in any detail, as all of these subjects are
+covered at length in the setuptools developer's guide and the
+``pkg_resources`` reference manual.
+
+Instead, this is **internal** documentation for how those concepts and
+features are *implemented* in concrete terms.  It is intended for people
+who are working on the setuptools code base, who want to be able to
+troubleshoot setuptools problems, want to write code that reads the file
+formats involved, or want to otherwise tinker with setuptools-generated
+files and directories.
+
+Note, however, that these are all internal implementation details and
+are therefore subject to change; stick to the published API if you don't
+want to be responsible for keeping your code from breaking when
+setuptools changes.  You have been warned.
+
+.. toctree::
+   :maxdepth: 1
+
+   formats
+   releases
+
diff --git a/docs/formats.txt b/docs/formats.txt
index dbfc2812..ef28353e 100644
--- a/docs/formats.txt
+++ b/docs/formats.txt
@@ -4,26 +4,6 @@ The Internal Structure of Python Eggs
 
 STOP! This is not the first document you should read!
 
-This document assumes you have at least some passing familiarity with
-*using* setuptools, the ``pkg_resources`` module, and EasyInstall.  It
-does not attempt to explain basic concepts like inter-project
-dependencies, nor does it contain detailed lexical syntax for most
-file formats.  Neither does it explain concepts like "namespace
-packages" or "resources" in any detail, as all of these subjects are
-covered at length in the setuptools developer's guide and the
-``pkg_resources`` reference manual.
-
-Instead, this is **internal** documentation for how those concepts and
-features are *implemented* in concrete terms.  It is intended for people
-who are working on the setuptools code base, who want to be able to
-troubleshoot setuptools problems, want to write code that reads the file
-formats involved, or want to otherwise tinker with setuptools-generated
-files and directories.
-
-Note, however, that these are all internal implementation details and
-are therefore subject to change; stick to the published API if you don't
-want to be responsible for keeping your code from breaking when
-setuptools changes.  You have been warned.
 
 
 .. contents:: **Table of Contents**
diff --git a/docs/index.txt b/docs/index.txt
index 162a5f6f..8c68651d 100644
--- a/docs/index.txt
+++ b/docs/index.txt
@@ -23,3 +23,4 @@ Documentation content:
    setuptools
    easy_install
    pkg_resources
+   development
diff --git a/docs/releases.txt b/docs/releases.txt
new file mode 100644
index 00000000..8119e8cf
--- /dev/null
+++ b/docs/releases.txt
@@ -0,0 +1,4 @@
+==========================
+Setuptools Release Process
+==========================
+