python/lib/django_1_4/docs/releases/1.1-rc-1.txt

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