add development and faq chapters

docs/development.rst

@@ -0,0 +1,70 @@
+Resources and Development
+=========================
+
+Supervisor has a maillist for users.  You may subscribe to the
+`Supervisor-users maillist
+<http://supervisord.org/mailman/listinfo/supervisor-users>`_.
+
+Supervisor has a maillist for checkins too.  You may subscribe to the
+`Supervisor-checkins maillist
+<http://supervisord.org/mailman/listinfo/supervisor-checkins>`_.
+
+Supervisor has a bugtracker where you may report any bugs or other
+errors you find.  Please report bugs to the `collector
+<http://www.plope.com/software/collector>`_.
+
+You can also view the `Supervisor version control repository
+<http://svn.supervisord.org>`_.
+
+Contributing
+------------
+
+If you'd like to contribute to supervisor, please contact us through
+the maillist and we'll attempt to arrange for you to have direct
+access to the version control repository.  You may be required to sign
+a contributor's agreement before you can be provided with access.
+
+Sponsoring
+----------
+
+If you'd like to sponsor further Supervisor development (for custom
+projects), please let one of the authors know.
+
+Author Information
+------------------
+
+The following people are responsible for creating Supervisor.
+
+Primary Authors and Maintainers
+-------------------------------
+
+- Chris McDonough (`Agendaless Consulting, Inc. <http://agendaless.com>`_)
+
+- Mike Naberezny (`Maintainable Software, Inc. <http://maintainable.com>`_)
+
+Contributors
+------------
+
+- Anders Quist: Anders contributed the patch that was the basis for
+  Supervisor’s ability to reload parts of its configuration without
+  restarting.
+
+- Derek DeVries: Derek did the web design of Supervisor’s internal web
+  interface and website logos.
+
+- Guido van Rossum: Guido authored ``zdrun`` and ``zdctl``, the
+  programs from Zope that were the original basis for Supervisor.  He
+  also created Python, the programming language that Supervisor is
+  written in.
+
+- Jason Kirtland: Jason fixed Supervisor to run on Python 2.6 by
+  contributing a patched version of Medusa (a Supervisor dependency)
+  that we now bundle.
+
+- Roger Hoover: Roger added support for spawning FastCGI programs. He
+  has also been one of the most active mailing list users, providing
+  his testing and feedback.
+
+- Siddhant Goel: Siddhant worked on :program:`supervisorctl` as our
+  Google Summer of Code student for 2008. He implemented the ``fg``
+  command and also added tab completion.

docs/faq.rst

@@ -0,0 +1,39 @@
+Frequently Asked Questions
+==========================
+
+Q
+  My program never starts and supervisor doesn't indicate any error?
+
+A 
+  Make sure the ``x`` bit is set on the executable file you're using in
+  the ``command=`` line of your program section.
+
+Q
+  I am a software author and I want my program to behave differently
+  when it's running under :program:`supervisord`.  How can I tell if
+  my program is running under :program:`supervisord`?
+
+A
+  Supervisor and its subprocesses share an environment variable
+  :envvar:`SUPERVISOR_ENABLED`.  When your program is run under
+  :program:`supervisord`, it can check for the presence of this
+  environment variable to determine whether it is running as a
+  :program:`supervisord` subprocess.
+
+Q
+  My command works fine when I invoke it by hand from a shell prompt,
+  but when I use the same command line in a supervisor program
+  ``command=`` section, the program fails mysteriously.  Why?
+
+A
+  This may be due to your process' dependence on environment variable
+  settings.  See "Subprocess Environment" elsewhere in this document.
+
+Q
+  How can I make Supervisor restart a process that's using "too much"
+  memory automatically?
+
+A
+  The :term:`superlance` package contains a console script that can be
+  used as a Supervisor event listener named ``memmon`` which helps
+  with this task.  It works on Linux and Mac OS X.

docs/index.rst

@@ -29,6 +29,8 @@ Narrative Documentation
    events.rst
    xmlrpc.rst
    upgrading.rst
+   faq.rst
+   development.rst
 
 API Documentation
 -----------------