| 1 | {{{ |
| 2 | #!text/x-rst |
| 3 | |
| 4 | =================== |
| 5 | Django 5.2 Roadmap |
| 6 | =================== |
| 7 | |
| 8 | This document details the schedule and roadmap towards Django 5.2. |
| 9 | |
| 10 | What features will be in Django 5.2? |
| 11 | ===================================== |
| 12 | |
| 13 | Whatever gets committed by the alpha feature freeze! |
| 14 | |
| 15 | Django 5.2 will be a time-based release. Any features completed and committed |
| 16 | to main by the alpha feature freeze deadline noted below will be included. Any |
| 17 | that miss the deadline won't. |
| 18 | |
| 19 | If you have a major feature you'd like to contribute, please introduce yourself |
| 20 | on the `django-internals forum category <https://forum.djangoproject.com/c/internals/5>`_ |
| 21 | so you can find a shepherd for your feature. |
| 22 | |
| 23 | Minor features and bug fixes will be merged as they are completed. If you |
| 24 | have submitted a patch, be sure the flags on the Trac ticket are correct such |
| 25 | that it appears in the "Patches needing review" filter of the `Django Development Dashboard <https://dashboard.djangoproject.com/>`_. Better yet, |
| 26 | find someone to review your patch and mark the ticket as "Ready for checkin". |
| 27 | Tickets marked "Ready for checkin" are regularly reviewed by mergers. |
| 28 | |
| 29 | Schedule |
| 30 | ======== |
| 31 | |
| 32 | Major milestones along the way to 5.2 are scheduled below. See `Process`_, |
| 33 | below, for more details. The dates are subject to change as necessary. |
| 34 | |
| 35 | ================== ====================================================== |
| 36 | January 15, 2025 Django 5.2 alpha; feature freeze. |
| 37 | |
| 38 | February 19 Django 5.2 beta; non-release blocking bug fix freeze. |
| 39 | |
| 40 | March 19 Django 5.2 RC 1; translation string freeze. |
| 41 | |
| 42 | April 2 Django 5.2 final |
| 43 | ================== ====================================================== |
| 44 | |
| 45 | Process |
| 46 | ======= |
| 47 | |
| 48 | Any features not completed by the feature freeze date won't make it into 5.2. |
| 49 | |
| 50 | Sarah Boyce, as the release manager, will be in charge of keeping the |
| 51 | schedule. The release manager keeps track of who's working on what issues so |
| 52 | that bug reports can be efficiently routed and also nag developers who are in |
| 53 | danger of missing deadlines. |
| 54 | |
| 55 | Feature freeze / Alpha 1 |
| 56 | ------------------------ |
| 57 | |
| 58 | All major and minor features must be merged by the Alpha 1 deadline. Any |
| 59 | features not done by this point will be deferred or dropped. At this time, we |
| 60 | will fork ``stable/5.2.x`` from ``main``. |
| 61 | |
| 62 | After the alpha, non-release blocking bug fixes may be backported at the |
| 63 | mergers' discretion. |
| 64 | |
| 65 | Beta 1 |
| 66 | ------ |
| 67 | |
| 68 | Beta 1 marks the end of any changes that aren't considered release blocking |
| 69 | bugs. A bug is a "Release blocker" if it's a regression from a previous version |
| 70 | of Django or if it's an important bug in a new feature. Only release blocking |
| 71 | bug fixes will be allowed to be backported after the beta. |
| 72 | |
| 73 | RC 1 |
| 74 | ---- |
| 75 | |
| 76 | If there is still a consistent stream of release blockers coming in at the |
| 77 | planned release candidate date; we'll release beta 2 to encourage further |
| 78 | testing and push the release candidate date out ~1 month. |
| 79 | |
| 80 | RC 1 marks the freeze for translation strings; translators will have two weeks |
| 81 | to submit updated translations for inclusion in the final release. Release |
| 82 | blocking bug fixes may continue to be backported. |
| 83 | |
| 84 | Final |
| 85 | ----- |
| 86 | |
| 87 | Ideally, Django 5.2 final will ship two weeks after the last RC. If there are |
| 88 | no major bugs found by 2 weeks after the release candidate, we will issue 5.2 |
| 89 | final. If not, we will decide how to proceed from there at that time (likely |
| 90 | another release candidate would be issued at some point). |
| 91 | |
| 92 | How you can help |
| 93 | ---------------- |
| 94 | |
| 95 | The only way we'll meet these deadlines is with a great deal of community |
| 96 | effort. To that end, here's how you can help: |
| 97 | |
| 98 | * Read the `guide to contributing to Django |
| 99 | <http://docs.djangoproject.com/en/dev/internals/contributing/>`_ and the |
| 100 | `guide to Django's release process |
| 101 | <http://docs.djangoproject.com/en/dev/internals/release-process/>`_. |
| 102 | |
| 103 | These guides explain how our process works. where to ask questions, etc. |
| 104 | It'll save everyone time if we're all on the same page when it comes to |
| 105 | process. |
| 106 | |
| 107 | * Work on patches and `triage tickets |
| 108 | <https://docs.djangoproject.com/en/dev/internals/contributing/triaging-tickets/>`_. |
| 109 | |
| 110 | * Attend a sprint (in person or in IRC). |
| 111 | |
| 112 | * Test the release snapshots (alphas, betas) against your code and report bugs. |
| 113 | |
| 114 | * We need *lots* of testers if we're to have a bug-free release. Download a |
| 115 | snapshot or a git checkout and give it a try! |
| 116 | }}} |