Fixed #8267: Corrected documentation for default value of DEFAULT_FILE_STORAGE setting
[django.git] / docs / release_notes_1.0_alpha_2.txt
blobc2f0ca5598684c8a810e3344e703432a7a47f82d
1 ================================
2 Django 1.0 alpha 2 release notes
3 ================================
6 Welcome to Django 1.0 alpha 2!
8 This is the second in a series of preview/development releases leading
9 up to the eventual release of Django 1.0, currently scheduled to take
10 place in early September 2008. This releases is primarily targeted at
11 developers who are interested in testing the Django codebase and
12 helping to identify and resolve bugs prior to the final 1.0 release.
14 As such, this release is *not* intended for production use, and any
15 such use is strongly discouraged.
18 What's new in Django 1.0 alpha 2
19 ================================
21 Django's development trunk has been the site of nearly constant
22 activity over the past year, with several major new features landing
23 since the 0.96 release. For features which were new as of Django 1.0
24 alpha 1, see `the 1.0 alpha 1 release notes`_. Since the 1.0 alpha 1
25 release several new features have landed, including:
27 ``django.contrib.gis`` (`GeoDjango`_)
28     A project over a year in the making, this adds world-class GIS
29     (`Geographic Information Systems`_) support to Django, in the form
30     of a ``contrib`` application.  `Its documentation`_ is currently
31     being maintained externally, and will be merged into the main
32     Django documentation prior to the final 1.0 release. Huge thanks
33     go to Justin Bronn, Jeremy Dunck, Brett Hoerner and Travis Pinney
34     for their efforts in creating and completing this feature.
36 Pluggable file storage
37     Django's built-in ``FileField`` and ``ImageField`` now can take
38     advantage of pluggable file-storage backends, allowing extensive
39     customization of where and how uploaded files get stored by
40     Django. For details, see `the files documentation`_; big thanks go
41     to Marty Alchin for putting in the hard work to get this
42     completed.
44 Jython compatibility
45     Thanks to a lot of work from Leo Soto during a Google Summer of
46     Code project, Django's codebase has been refactored to remove
47     incompatibilities with `Jython`_, an implementation of Python
48     written in Java, which runs Python code on the Java Virtual
49     Machine. Django is now compatible with the forthcoming Jython 2.5
50     release.
52 There are many other new features and improvements in this release,
53 including two major performance boosts: strings marked for translation
54 using `Django's internationalization system`_ now consume far less
55 memory, and Django's internal dispatcher -- which is invoked
56 frequently during request/response processing and when working with
57 Django's object-relational mapper -- is now significantly faster.
58     
59 .. _the 1.0 alpha 1 release notes: ../release_notes_1.0_alpha/
60 .. _GeoDjango: http://geodjango.org/
61 .. _Geographic Information Systems: http://en.wikipedia.org/wiki/Geographic_information_system
62 .. _Its documentation: http://geodjango.org/docs/
63 .. _the files documentation: ../files/
64 .. _Jython: http://www.jython.org/
65 .. _Django's internationalization system: ../i18n/
68 The Django 1.0 roadmap
69 ======================
71 One of the primary goals of this alpha release is to focus attention
72 on the remaining features to be implemented for Django 1.0, and on the
73 bugs that need to be resolved before the final release. Following this
74 release, we'll be conducting a series of development sprints building
75 up to the beta and release-candidate stages, followed soon after by
76 Django 1.0. The timeline is projected to be:
78 * **August 14, 2008: Django 1.0 beta release.** Past this point Django
79   will be in a "feature freeze" for the 1.0 release; after Django 1.0
80   beta, the development focus will be solely on bug fixes and
81   stabilization.
83 * August 15, 2008: Sprint (based in Austin, Texas, USA, and online).
85 * August 17, 2008: Sprint (based in Tel Aviv, Israel, and online).
87 * **August 21, 2008: Django 1.0 release candidate 1.** At this point,
88   all strings marked for translation within Django's codebase will be
89   frozen, to provide contributors time to check and finalize all of
90   Django's bundled translation files prior to the final 1.0 release.
92 * August 22, 2008: Sprint (based in Portland, Oregon, USA, and online).
94 * **August 26, 2008: Django 1.0 release candidate 2.**
96 * August 30, 2008: Sprint (based in London, England, UK, and online).
98 * **September 2, 2008: Django 1.0 final release.** The official Django
99   1.0 release party will take place during the first-ever DjangoCon,
100   to be held in Mountain View, California, USA, September 6-7.
102 Of course, like any estimated timeline, this is subject to change as
103 requirements dictate. The latest information will always be available
104 on the Django project wiki:
106     http://code.djangoproject.com/wiki/VersionOneRoadmap
109 What you can do to help
110 =======================
112 In order to provide a high-quality 1.0 release, we need your
113 help. Although this alpha release is, again, *not* intended for
114 production use, you can help the Django team by trying out the alpha
115 codebase in a safe test environment and reporting any bugs or issues
116 you encounter. The Django ticket tracker is the central place to
117 search for open issues:
119     http://code.djangoproject.com/timeline
121 Please open new tickets if no existing ticket corresponds to a problem
122 you're running into.
124 Additionally, discussion of Django development, including progress
125 toward the 1.0 release, takes place daily on the django-developers
126 mailing list:
128     http://groups.google.com/group/django-developers
130 ...and in the ``#django-dev`` IRC channel on ``irc.freenode.net``. If
131 you're interested in helping out with Django's development, feel free
132 to join the discussions there.
134 Django's online documentation also includes pointers on how to
135 contribute to Django:
137     http://www.djangoproject.com/documentation/contributing/
139 Contributions on any level -- developing code, writing
140 documentation or simply triaging tickets and helping to test proposed
141 bugfixes -- are always welcome and appreciated.