Merge "ODL Parent Oxygen M1 read-out"
[docs.git] / docs / release-process / release-schedule.rst
1 ================
2 Release Schedule
3 ================
4
5 While OpenDaylight has always targeted two releases per year, in practice our
6 release process for the first six releases (through Carbon) has, in practice,
7 released approximately every 8 months. This has meant we don't quite release
8 twice a year (Lithium was our only release in 2015) and we struggle to
9 coordinate releases with other projects that release at regular times each
10 year, e.g., OpenStack and OPNFV.
11
12 To try to fix this, we had a short Nitrogen release and then we move to
13 a date-based, six-month release calendar releasing at the same time each year.
14 Oxygen is the first date-based release of 2018.
15
16 Oxygen
17 ========
18
19 +-----------+------------+------------+------------+----------------------------------------+
20 | Milestone | offset 0   | offset 1   |  offset 2  | Description                            |
21 +===========+============+============+============+========================================+
22 |      M0   | 2017/09/07 | 2017/09/07 | 2017/09/07 | Declare Intent                         |
23 +-----------+------------+------------+------------+----------------------------------------+
24 |      M1   | 2017/10/07 | 2017/10/14 | 2017/10/21 | Final Release Plan, Project Setup      |
25 +-----------+------------+------------+------------+----------------------------------------+
26 |      M2   | 2017/11/07 | 2017/11/14 | 2017/11/21 | Functionality Freeze                   |
27 +-----------+------------+------------+------------+----------------------------------------+
28 |      M3   | 2017/12/07 | 2017/12/14 | 2017/12/21 | API Freeze                             |
29 +-----------+------------+------------+------------+----------------------------------------+
30 |      M4   | 2018/01/07 | 2018/01/14 | 2018/01/21 | Code Freeze *(note M3-M4 will likely   |
31 |           |            |            |            | be short since it includes 12/25-1/1)* |
32 +-----------+------------+------------+------------+----------------------------------------+
33 |     RC0   | 2018/02/07 |    N/A     |    N/A     | All projects must be in the            |
34 |           |            |            |            | distribution and autorelease           |
35 +-----------+------------+------------+------------+----------------------------------------+
36 |     RC1   | 2018/02/14 |    N/A     |    N/A     | Lock branches                          |
37 +-----------+------------+------------+------------+----------------------------------------+
38 |     RC2   | 2018/02/21 |    N/A     |    N/A     | Only merge blocking bugs               |
39 +-----------+------------+------------+------------+----------------------------------------+
40 |     RC3   | 2018/02/28 |    N/A     |    N/A     | Release Reviews, All known blockers    |
41 |           |            |            |            | addressed/merged                       |
42 +-----------+------------+------------+------------+----------------------------------------+
43 | Release   | 2018/03/07 |            |            |                                        |
44 +-----------+------------+------------+------------+----------------------------------------+
45 |     SR1   | 2018/04/07 |            |            |                                        |
46 +-----------+------------+------------+------------+----------------------------------------+
47 |     SR2   | 2018/06/07 |            |            |                                        |
48 +-----------+------------+------------+------------+----------------------------------------+
49 |     SR3   | 2018/08/07 |            |            |                                        |
50 +-----------+------------+------------+------------+----------------------------------------+
51 |     SR4   | 2018/09/21 |            |            |                                        |
52 |           | -          |            |            |                                        |
53 |           | 2018/11/07 |            |            |                                        |
54 +-----------+------------+------------+------------+----------------------------------------+
55
56 .. note:: Dates are calendar based on the 7th, 14th, 21st, and 28th of each month instead of being
57           on a particular day of the week. The intent is that projects will figure out how to meet
58           the deadline in the way that best works for them even if that means getting work done
59           ahead of time to avoid holidays, weekends, vacation or travel.
60
61 Future Odd Releases
62 ===================
63
64 Starting with Oxygen, our odd-numbered element releases will look like this:
65
66 +-----------+-----------+-------+-------+----------------------------------------+
67 | Milestone | off0      | off1  | off2  | Description                            |
68 +===========+===========+=======+=======+========================================+
69 |      M0   | 9/7       |       |       | Draft Release Plan                     |
70 +-----------+-----------+-------+-------+----------------------------------------+
71 |      M1   | 10/7      | 10/14 | 10/21 | Final Release Plan, Project Setup      |
72 +-----------+-----------+-------+-------+----------------------------------------+
73 |      M2   | 11/7      | 11/14 | 11/21 | Functionality Freeze                   |
74 +-----------+-----------+-------+-------+----------------------------------------+
75 |      M3   | 12/7      | 12/14 | 12/21 | API Freeze                             |
76 +-----------+-----------+-------+-------+----------------------------------------+
77 |      M4   | 1/7       | 1/14  | 1/21  | Code Freeze *(note M3-M4 will likely   |
78 |           |           |       |       | be short since it includes 12/25-1/1)* |
79 +-----------+-----------+-------+-------+----------------------------------------+
80 |     RCs   | 1/21-3/7  |       |       | (continuous build)                     |
81 +-----------+-----------+-------+-------+----------------------------------------+
82 | Release   | 3/7       |       |       |                                        |
83 +-----------+-----------+-------+-------+----------------------------------------+
84 |     SR1   | 4/7       |       |       |                                        |
85 +-----------+-----------+-------+-------+----------------------------------------+
86 |     SR2   | 6/7       |       |       |                                        |
87 +-----------+-----------+-------+-------+----------------------------------------+
88 |     SR3   | 8/7       |       |       |                                        |
89 +-----------+-----------+-------+-------+----------------------------------------+
90 |     SR4   | 9/21-11/7 |       |       |                                        |
91 +-----------+-----------+-------+-------+----------------------------------------+
92
93 Future Even Releases
94 ====================
95
96 Starting with Fluorine, our even-numbered element releases will look like this:
97
98 +-----------+-----------+-------+-------+----------------------------------------+
99 | Milestone | off0      | off1  | off2  | Description                            |
100 +===========+===========+=======+=======+========================================+
101 |      M0   | 3/7       |       |       | Draft Release Plan                     |
102 +-----------+-----------+-------+-------+----------------------------------------+
103 |      M1   | 4/7       | 4/14  | 4/21  | Final Release Plan, Project Setup      |
104 +-----------+-----------+-------+-------+----------------------------------------+
105 |      M2   | 5/7       | 5/14  | 5/21  | Functionality Freeze                   |
106 +-----------+-----------+-------+-------+----------------------------------------+
107 |      M3   | 6/7       | 6/14  | 6/21  | API Freeze                             |
108 +-----------+-----------+-------+-------+----------------------------------------+
109 |      M4   | 7/7       | 7/14  | 7/21  | Code Freeze                            |
110 +-----------+-----------+-------+-------+----------------------------------------+
111 |     RCs   | 7/21-9/7  |       |       | (continuous build)                     |
112 +-----------+-----------+-------+-------+----------------------------------------+
113 | Release   | 9/7       |       |       |                                        |
114 +-----------+-----------+-------+-------+----------------------------------------+
115 |     SR1   | 10/7      |       |       |                                        |
116 +-----------+-----------+-------+-------+----------------------------------------+
117 |     SR2   | 12/7      |       |       |                                        |
118 +-----------+-----------+-------+-------+----------------------------------------+
119 |     SR3   | 2/7       |       |       |                                        |
120 +-----------+-----------+-------+-------+----------------------------------------+
121 |     SR4   | 3/21-5/7  |       |       |                                        |
122 +-----------+-----------+-------+-------+----------------------------------------+