Opened 18 years ago

Closed 18 years ago

#2733 closed task (wontfix)

Need to branch documentation for 0.95

Reported by: Russell Keith-Magee Owned by: Jacob
Component: *.djangoproject.com Version: 0.95
Severity: normal Keywords: 0.95 documentation
Cc: freakboy3742@… Triage Stage: Unreviewed
Has patch: no Needs documentation: no
Needs tests: no Patch needs improvement: no
Easy pickings: no UI/UX: no

Description

SVN trunk is starting to diverge slightly from the state of 0.95; as a result, the statement:

   This covers Django version 0.95 and the development version. Old docs: 0.90, 0.91

at the start of each documentation page is occasionally a little misleading (e.g., new options to django-admin, new settings for the Test system).

We should branch the 0.95 documentation on the website in the same way 0.90 and 0.91 is currently branched.

Change History (1)

comment:1 by Adrian Holovaty, 18 years ago

Resolution: wontfix
Status: newclosed

This is our policy, so I think it should stay as is, for now. The reasoning is twofold: First, we often make improvements to the current documentation, and these improvements are valid for 0.95 users -- so it wouldn't make sense to freeze the 0.95 documentation at time of the 0.95 release. Second, comments should only be available on *one version* of the docs, to prevent confusion, and it makes most sense to allow comments on the most recent docs, rather than docs that might have been corrected in some subsequent version somewhere.

Note: See TracTickets for help on using tickets.
Back to Top