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