|
| 1 | +.. _releases-1.1-rc-1: |
| 2 | + |
| 3 | +============================= |
| 4 | +Django 1.1 RC 1 release notes |
| 5 | +============================= |
| 6 | + |
| 7 | + |
| 8 | +July 21, 2009 |
| 9 | + |
| 10 | +Welcome to the first Django 1.1 release candidate! |
| 11 | + |
| 12 | +This is the third -- and likely last -- in a series of |
| 13 | +preview/development releases leading up to the eventual release of |
| 14 | +Django 1.1, currently scheduled to take place approximately one week |
| 15 | +after this release candidate. This release is targeted primarily at |
| 16 | +developers who are interested in trying out new features and testing |
| 17 | +the Django codebase to help identify and resolve any critical bugs |
| 18 | +prior to the final 1.1 release. |
| 19 | + |
| 20 | +As such, this release is not yet intended for production use, and any |
| 21 | +such use is discouraged. |
| 22 | + |
| 23 | + |
| 24 | +What's new in Django 1.1 RC 1 |
| 25 | +============================= |
| 26 | + |
| 27 | +The Django codebase has -- with one exception -- been in feature |
| 28 | +freeze since the first 1.1 beta release, and so this release candidate |
| 29 | +contains only one new feature (see below); work leading up to this |
| 30 | +release candidate has instead been focused on bugfixing, particularly |
| 31 | +on the new features introduced prior to the 1.1 beta. |
| 32 | + |
| 33 | +For an overview of those features, consult :ref:`the Django 1.1 beta |
| 34 | +release notes <releases-1.1-beta-1>`. |
| 35 | + |
| 36 | + |
| 37 | +URL namespaces |
| 38 | +-------------- |
| 39 | + |
| 40 | +The 1.1 beta release introduced the ability to use reverse URL |
| 41 | +resolution with Django's admin application, which exposed a set of |
| 42 | +:ref:`named URLs <naming-url-patterns>`. Unfortunately, achieving |
| 43 | +consistent and correct reverse resolution for admin URLs proved |
| 44 | +extremely difficult, and so one additional feature was added to Django |
| 45 | +to resolve this issue: URL namespaces. |
| 46 | + |
| 47 | +In short, this feature allows the same group of URLs, from the same |
| 48 | +application, to be included in a Django URLConf multiple times, with |
| 49 | +varying (and potentially nested) named prefixes which will be used |
| 50 | +when performing reverse resolution. For full details, see :ref:`the |
| 51 | +documentation on defining URL namespaces |
| 52 | +<topics-http-defining-url-namespaces>`. |
| 53 | + |
| 54 | +Due to the changes needed to support this feature, the URL pattern |
| 55 | +names used when reversing admin URLs have changed since the 1.1 beta |
| 56 | +release; if you were developing applications which took advantage of |
| 57 | +this new feature, you will need to update your code to reflect the new |
| 58 | +names (for most purposes, changing ``admin_`` to ``admin:`` in names |
| 59 | +to be reversed will suffice). For a full list of URL pattern names |
| 60 | +used by the admin and information on how namespaces are applied to |
| 61 | +them, consult the documentation on :ref:`reversing admin URLs |
| 62 | +<admin-reverse-urls>`. |
| 63 | + |
| 64 | + |
| 65 | +The Django 1.1 roadmap |
| 66 | +====================== |
| 67 | + |
| 68 | +As of this release candidate, Django 1.1 is in both feature freeze and |
| 69 | +"string freeze" -- all strings marked for translation in the Django |
| 70 | +codebase will retain their current form in the final Django 1.1 |
| 71 | +release. Only critical release-blocking bugs will receive attention |
| 72 | +between now and the final 1.1 release. |
| 73 | + |
| 74 | +If no such bugs are discovered, Django 1.1 will be released |
| 75 | +approximately one week after this release candidate, on or about July |
| 76 | +28, 2009. |
| 77 | + |
| 78 | + |
| 79 | +What you can do to help |
| 80 | +======================= |
| 81 | + |
| 82 | +In order to provide a high-quality 1.1 release, we need your |
| 83 | +help. Although this release candidate is, again, *not* intended for |
| 84 | +production use, you can help the Django team by trying out this |
| 85 | +release candidate in a safe testing environment and reporting any bugs |
| 86 | +or issues you encounter. The Django ticket tracker is the central |
| 87 | +place to search for open issues: |
| 88 | + |
| 89 | + * http://code.djangoproject.com/timeline |
| 90 | + |
| 91 | +Please open a new ticket only if no existing ticket corresponds to a |
| 92 | +problem you're running into. |
| 93 | + |
| 94 | +Additionally, discussion of Django development, including progress |
| 95 | +toward the 1.1 release, takes place daily on the django-developers |
| 96 | +mailing list: |
| 97 | + |
| 98 | + * http://groups.google.com/group/django-developers |
| 99 | + |
| 100 | +... and in the ``#django-dev`` IRC channel on ``irc.freenode.net``. If you're |
| 101 | +interested in helping out with Django's development, feel free to join the |
| 102 | +discussions there. |
| 103 | + |
| 104 | +Django's online documentation also includes pointers on how to contribute to |
| 105 | +Django: |
| 106 | + |
| 107 | + * :ref:`How to contribute to Django <internals-contributing>` |
| 108 | + |
| 109 | +Contributions on any level -- developing code, writing documentation or simply |
| 110 | +triaging tickets and helping to test proposed bugfixes -- are always welcome and |
| 111 | +appreciated. |
0 commit comments