Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Browse code

Fixed #19180 - Clarified policy regarding older versions of the docs.

  • Loading branch information...
commit 5c143cb340df6825714a6317901b6df03d4ef4b0 1 parent f2fd4eb
Tim Graham authored October 25, 2012
5  docs/internals/contributing/writing-documentation.txt
@@ -30,8 +30,9 @@ If you'd like to start contributing to our docs, get the development version of
30 30
 Django from the source code repository
31 31
 (see :ref:`installing-development-version`). The development version has the
32 32
 latest-and-greatest documentation, just as it has latest-and-greatest code.
33  
-Generally, we only revise documentation in the development version, as our
34  
-policy is to freeze documentation for existing releases (see
  33
+We also backport documentation fixes and improvements, at the discretion of the
  34
+committer, to the last release branch. That's because it's highly advantageous
  35
+to have the docs for the last release be up-to-date and correct (see
35 36
 :ref:`differences-between-doc-versions`).
36 37
 
37 38
 Getting started with Sphinx
14  docs/intro/whatsnext.txt
@@ -216,15 +216,13 @@ We follow this policy:
216 216
   "New in version X.Y", being X.Y the next release version (hence, the one
217 217
   being developed).
218 218
 
219  
-* Documentation for a particular Django release is frozen once the version
220  
-  has been released officially. It remains a snapshot of the docs as of the
221  
-  moment of the release. We will make exceptions to this rule in
222  
-  the case of retroactive security updates or other such retroactive
223  
-  changes. Once documentation is frozen, we add a note to the top of each
224  
-  frozen document that says "These docs are frozen for Django version XXX"
225  
-  and links to the current version of that document.
  219
+* Documentation fixes and improvements may be backported to the last release
  220
+  branch, at the discretion of the committer, however, once a version of
  221
+  Django is :ref:`no longer supported<backwards-compatibility-policy>`, that
  222
+  version of the docs won't get any further updates.
226 223
 
227 224
 * The `main documentation Web page`_ includes links to documentation for
228  
-  all previous versions.
  225
+  all previous versions. Be sure you are using the version of the docs
  226
+  corresponding to the version of Django you are using!
229 227
 
230 228
 .. _main documentation Web page: https://docs.djangoproject.com/en/dev/

0 notes on commit 5c143cb

Please sign in to comment.
Something went wrong with that request. Please try again.