Add sections for Reporting Issues and Support to docs.

Author: grantjenks

README.rst

@@ -143,40 +143,48 @@ Containers`_.
 Documentation
 -------------
 
-Complete documentation including performance comparisons is available at
+Complete documentation for `Sorted Containers`_ is available at
 http://www.grantjenks.com/docs/sortedcontainers/
 
 User Guide
 ..........
 
-For those wanting more details, this part of the documentation describes
-introduction, implementation, performance, and development.
+The user guide provides an introduction to `Sorted Containers`_ and extensive
+performance comparisons and analysis.
 
 - `Introduction`_
 - `Performance Comparison`_
 - `Load Factor Performance Comparison`_
 - `Runtime Performance Comparison`_
 - `Simulated Workload Performance Comparison`_
-- `Implementation Details`_
 - `Performance at Scale`_
-- `Developing and Contributing`_
-- `Release History`_
 
 .. _`Introduction`: http://www.grantjenks.com/docs/sortedcontainers/introduction.html
 .. _`Performance Comparison`: http://www.grantjenks.com/docs/sortedcontainers/performance.html
 .. _`Load Factor Performance Comparison`: http://www.grantjenks.com/docs/sortedcontainers/performance-load.html
 .. _`Runtime Performance Comparison`: http://www.grantjenks.com/docs/sortedcontainers/performance-runtime.html
 .. _`Simulated Workload Performance Comparison`: http://www.grantjenks.com/docs/sortedcontainers/performance-workload.html
-.. _`Implementation Details`: http://www.grantjenks.com/docs/sortedcontainers/implementation.html
 .. _`Performance at Scale`: http://www.grantjenks.com/docs/sortedcontainers/performance-scale.html
-.. _`Developing and Contributing`: http://www.grantjenks.com/docs/sortedcontainers/development.html
+
+Community Guide
+...............
+
+The community guide provides information on the development of `Sorted
+Containers`_ along with support, implementation, and history details.
+
+- `Development and Support`_
+- `Implementation Details`_
+- `Release History`_
+
+.. _`Development and Support`: http://www.grantjenks.com/docs/sortedcontainers/development.html
+.. _`Implementation Details`: http://www.grantjenks.com/docs/sortedcontainers/implementation.html
 .. _`Release History`: http://www.grantjenks.com/docs/sortedcontainers/history.html
 
 API Documentation
 .................
 
-If you are looking for information on a specific function, class or method,
-this part of the documentation is for you.
+The API documentation provides information on specific functions, classes, and
+modules in the `Sorted Containers`_ package.
 
 - `Sorted List`_
 - `Sorted Dict`_
@@ -197,8 +205,8 @@ Talks
 .. _`SF Python Holiday Party 2015 Lightning Talk`: http://www.grantjenks.com/docs/sortedcontainers/sf-python-2015-lightning-talk.html
 .. _`DjangoCon 2015 Lightning Talk`: http://www.grantjenks.com/docs/sortedcontainers/djangocon-2015-lightning-talk.html
 
-Useful Links
-------------
+Resources
+---------
 
 - `Sorted Containers Documentation`_
 - `Sorted Containers at PyPI`_

docs/development.rst

@@ -1,5 +1,49 @@
-Developing and Contributing
-===========================
+Development and Support
+=======================
+
+.. contents::
+   :depth: 1
+   :local:
+
+Reporting Issues
+----------------
+
+Support requests, bugs, issues, documentation typos, and general questions
+should be submitted via the `GitHub Issue Tracker`_. The issue tracker offers a
+web interface which allows relevant information to be entered and submitted to
+the :doc:`Sorted Containers<index>` developers. Steps to file an issue:
+
+#. Please search the issues database to determine whether the problem has
+   already been reported. It may be that a fix or workaround has already been
+   provided or is soon to be released. If additional information is needed then
+   you are welcome to reopen the issue and comment regarding your specific
+   scenario.
+#. To file a new issue, click the green "New issue" button on the Issue
+   Tracker. You will be required to sign-in to file an issue. It is not
+   possible to submit an issue anonymously.
+#. The issue form has two primary fields: title and comment. The title should
+   be a very short description of the problem; preferably less than ten words.
+   The comment should describe the problem in detail, including what you
+   expected to happen and what instead did happen. Working code samples that
+   illustrate the issue are best.
+#. Submitted issues and comments will notify the lead developer and project
+   maintainers. Bugs are typically fixed very quickly, within a week or so.
+   Feature enhancements may take longer or be deferred until a pull request is
+   made with a working prototype.
+
+Support
+-------
+
+Development of :doc:`Sorted Containers<index>` is lead by Grant Jenks
+<[email protected]>. The preferred method of contact for support is to
+create an issue on the `GitHub Issue Tracker`_. For anything sensitive, such as
+conduct issues or security issues, please contact the development lead directly
+by email.
+
+.. _`GitHub Issue Tracker`: https://github.com/grantjenks/python-sortedcontainers/issues
+
+How to Contribute?
+------------------
 
 Collaborators are welcome!
 
@@ -8,16 +52,11 @@ Collaborators are welcome!
 #. Fork the `repository`_ on GitHub and start making your changes to a new
    branch.
 #. Write a test which shows that the bug was fixed.
-#. Send a pull request and bug the maintainer until it gets merged and
+#. Send a pull request and bug the development lead until it gets merged and
    published :)
 
 .. _`repository`: https://github.com/grantjenks/python-sortedcontainers
 
-Development Lead
-----------------
-
-* Grant Jenks <[email protected]>
-
 Requests for Contributions
 --------------------------
 

docs/index.rst

@@ -8,9 +8,9 @@
    performance-load
    performance-runtime
    performance-workload
-   implementation
    performance-scale
    development
+   implementation
    history
    sortedlist
    sorteddict