Merge pull request #66 from benoitbryon/65-versions-kgs

Closes #65 - Added notes about requirements and known good set of versions in INSTALL

CHANGELOG

@@ -8,7 +8,7 @@ future releases, check `milestones`_ and :doc:`/about/vision`.
 1.4 (unreleased)
 ----------------
 
-Bugfixes.
+Bugfixes and documentation features.
 
 - Bugfix #43 - ``ObjectDownloadView`` returns HTTP 404 if model instance's file
   field is empty (was HTTP 500).
@@ -18,6 +18,9 @@ Bugfixes.
 
 - Feature #10 - `django-downloadview` is registered on djangopackages.com.
 
+- Feature #65 - INSTALL documentation shows "known good set" (KGS) of versions,
+  i.e. versions that have been used in test environment.
+
 
 1.3 (2013-11-08)
 ----------------

INSTALL

@@ -17,12 +17,32 @@ pip:
 
    pip install django-downloadview
 
+Installing `django-downloadview` will automatically trigger the installation of
+the following requirements:
+
+.. literalinclude:: /../setup.py
+   :language: python
+   :lines: 35
+
 .. note::
 
    Since version 1.1, django-downloadview requires Django>=1.5, which provides
    :py:class:`~django.http.StreamingHttpResponse`.
 
 
+**************************
+Known good set of versions
+**************************
+
+`django-downloadview` has been tested in an environment with the following set
+of versions. If something is going wrong with other versions, please report it
+in `django-downloadview's bugtracker`_.
+
+.. literalinclude:: /../etc/buildout.cfg
+   :language: ini
+   :lines: 67-
+
+
 .. rubric:: Notes & references
 
 .. seealso::
@@ -30,3 +50,8 @@ pip:
    * :doc:`/settings`
    * :doc:`/about/changelog`
    * :doc:`/about/license`
+
+.. target-notes::
+
+.. _`django-downloadview's bugtracker`:
+   https://github.com/benoitbryon/django-downloadview/issues