From 2e6aa7a57818f1c2b7f17253430c38a8d67f9171 Mon Sep 17 00:00:00 2001 From: Adrian Holovaty Date: Fri, 11 Aug 2006 20:31:43 +0000 Subject: [PATCH] Added paragraph to docs/documentation.txt about removing comments from frozen docs git-svn-id: http://code.djangoproject.com/svn/django/trunk@3561 bcc190cf-cafb-0310-a4f2-bffc1f526a37 --- docs/documentation.txt | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/documentation.txt b/docs/documentation.txt index 232c6f4537..bacfb176b1 100644 --- a/docs/documentation.txt +++ b/docs/documentation.txt @@ -134,6 +134,14 @@ We follow this policy: frozen document that says "These docs are frozen for Django version XXX" and links to the current version of that document. + * Once a document is frozen for a Django release, we remove comments from + that page, in favor of having comments on the latest version of that + document. This is for the sake of maintainability and usability, so that + users have one, and only one, place to leave comments on a particular + document. We realize that some people may be stuck on a previous version + of Django, but we believe the usability problems with multiple versions + of a document the outweigh the benefits. + * The `main documentation Web page`_ includes links to documentation for all previous versions.