-django-middleware-extras provides some extra middleware classes that are
-often needed by Django projects.
-Project Development Web Site:
- * https://www.codetrax.org/projects/django-middleware-extras
+| **Author**: `George Notaras <http://www.g-loaded.eu/>`_
+| **Development Web Site**: `django-middleware-extras project <http://www.codetrax.org/projects/django-middleware-extras>`_
+| **Source Code Repository**: `django-middleware-extras source code <https://source.codetrax.org/hgroot/django-middleware-extras>`_
+| **Documentation**: `django-middleware-extras documentation <http://packages.python.org/django-middleware-extras>`_
+| **Downloads**: `django-middleware-extras releases <http://pypi.python.org/pypi/django-middleware-extras>`_
-Public Source Code Repository:
- * https://source.codetrax.org/hgroot/django-middleware-extras
+Licensed under the *Apache License version 2.0*. More licensing information
+exists in the license_ section.
-How this distribution package is organized
-The following list outlines the kind of information each of the files of this
-distribution package contains:
- * AUTHORS : List of all authors and contributors.
- * BUGS : Information about how to file bug reports or ask for new features.
- * HELP : Instructions on how to use this software.
- * INSTALL : Information on how to install this application.
- * LICENSE : The terms of the license that governs your use of this software.
- * NOTICE : Copyright, trademark, attribution and sponsorship information.
- * SUPPORT : Information on how to get support for this software.
-How to read the HELP document
-The HELP document is written in reStructuredText (rst). Although
-reStructuredText is an easy-to-read plain text markup format, it is
-recommended to convert it to HTML for a better reading experience.
-In order to convert this document to HTML you need `docutils`, which
-you can install in your system using `pip`::
+Apart from the `django-middleware-extras Online Documentation`_, more information about the
+installation, configuration and usage of this application may be available
+.. _`django-middleware-extras Online Documentation`: http://packages.python.org/django-middleware-extras
+.. _wiki: http://www.codetrax.org/projects/django-middleware-extras/wiki
-Once `docutils` is installed, you can use the `rst2html.py` utility to
- rst2html.py HELP help.html
+This software is released as free-software and provided to you at no cost. However,
+a significant amount of time and effort has gone into developing this software
+and writing this documentation. So, the production of this software has not
+been free from cost. It is highly recommended that, if you use this software
+*in production*, you should consider making a donation.
-Then use any web browser to view the exported `help.html` file.
+To make a donation, please visit the CodeTRAX `donations page`_ which contains
+a PayPal_ *donate* button.
+Thank you for considering making a donation to django-middleware-extras.
+.. _`donations page`: https://source.codetrax.org/donate.html
+.. _PayPal: https://www.paypal.com
+Bugs and feature requests
+In case you run into any problems while using this application or think that
+a new feature should be implemented, it is highly recommended you submit_ a new
+report about it at the project's `issue tracker`_.
+Using the *issue tracker* is the recommended way to notify the authors about
+bugs or make feature requests. Also, before submitting a new report, please
+make sure you have read the `new issue guidelines`_.
+.. _submit: http://www.codetrax.org/projects/django-middleware-extras/issues/new
+.. _`issue tracker`: http://www.codetrax.org/projects/django-middleware-extras/issues
+.. _`new issue guidelines`: http://www.codetrax.org/NewIssueGuidelines
+CodeTRAX does not provide support for django-middleware-extras.
+You can still get community support at the `Community Support Forums`_:
+.. _`Community Support Forums`: http://www.codetrax.org/projects/django-middleware-extras/boards
Copyright 2010 George Notaras <gnot [at] g-loaded.eu>
-Licensed under the Apache License, Version 2.0 (the "License");
+Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
Unless required by applicable law or agreed to in writing, software
See the License for the specific language governing permissions and
limitations under the License.
-A copy of the License exists in the product distribution; the LICENSE file.
-For copyright notes please read the NOTICE file.
+A copy of the License exists in the product distribution; the *LICENSE* file.
+For copyright and other important notes regarding this release please read