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.
Note:
See TracTickets
for help on using tickets.
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.