What's the policy about all those references to release notes in the docs? For example, the autoescape template tag [1] has "New in Django 1.0: Please, see the release notes", with a link to the 1.0 release notes. When can these be removed?
It's clearly a bad idea to rely on the release notes as a long-term place to document features. I'm using the autoescape tag as example because this case is particularly degenerate: the release notes [2] referenced by the template tag docs point the user back to the template tag they just came from; meanwhile, the right place to look for autoescaping documentation is actually the template docs [3], which neither of the first two pages link to. Should the release notes be updated? No -- the links to the release notes should be removed, and features that require clarification should point to the current docs instead. If this policy question is already answered elsewhere, perhaps the information should be added to the Release Process page. [1] http://docs.djangoproject.com/en/dev/ref/templates/builtins/#ttag-autoescape [2] http://docs.djangoproject.com/en/dev/releases/1.0/#automatic-escaping-of-template-variables [3] http://docs.djangoproject.com/en/dev/topics/templates/#id2 -- You received this message because you are subscribed to the Google Groups "Django developers" group. To post to this group, send email to [email protected]. To unsubscribe from this group, send email to [email protected]. For more options, visit this group at http://groups.google.com/group/django-developers?hl=en.
