Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

doc/releases: update release cycle docs #18117

Merged
merged 2 commits into from Oct 6, 2017
Merged

Conversation

liewegas
Copy link
Member

@liewegas liewegas commented Oct 4, 2017

Signed-off-by: Sage Weil sage@redhat.com

Copy link

@dillaman dillaman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The definition of LTS was dropped but it's still used in the release timeline at the top of the document. Given the new definition of "stable", one would think that Kraken should still be supported.

@liewegas
Copy link
Member Author

liewegas commented Oct 4, 2017

Updated:

  • removed LTS vs Stable from chart
  • added EOL in its place for retired releases
  • added paragraph about Jewel and Kraken diverging from the (new) pattern

@ceph-jenkins
Copy link
Collaborator

OK - docs built

@@ -7,7 +7,7 @@ Timeline

+----------------------+-------------+-----------+----------+---------------+-----------+----------+------------+------------+-------------+
| | `Luminous`_ | `Kraken`_ | `Jewel`_ | `Infernalis`_ | `Hammer`_ | `Giant`_ | `Firefly`_ | `Emperor`_ | `Dumpling`_ |
| | LTS | Stable | LTS | Stable | LTS | Stable | LTS | Stable | LTS |
| | | EOL | | EOL | EOL | EOL | EOL | EOL | EOL |

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

tabs left


Each development release (x.0.z) freezes the master development branch
and applies `integration and upgrade tests
<https://github.com/ceph/ceph-qa-suite>`_ before it is released. Once

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

extra _ after >


The life time for Jewel and Kraken are slightly different. Prior to
Luminous, only every other stable release was an "LTS" release.
Therefore,

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

why gap in therefore? and commencing line

doc/releases.rst Outdated
stable release series will receive a name (e.g., 'Jewel') and a major
release number (e.g., 10 for Jewel because 'J' is the 10th letter of
the alphabet). Each release has a version like 10.y.z.

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe we should use "Mimic" examples in section as this is new policy which wasn't present when Jewel was current?

doc/releases.rst Outdated
* Long Term Stable : until the next two LTS are published
* Stable release : until the next stable release is published
* Development / testing release : no backports
There is a new stable release cycle every nine (9) months. Each
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we mention that this applies only after L, from Luminous release of ceph,

doc/releases.rst Outdated
small feature backports. Bug fixes are accumulated and included in
the next point release.

* Stable point release every 3 to 6 weeks
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

more realistically 4-6 weeks?

doc/releases.rst Outdated
extended to May 2015.
In the timeline, the life time of a stable release series is
calculated to be approximately 18 months after the month of the first
release. The lifetime of a release may vary because it depend on how
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

s/depend/depends/

doc/releases.rst Outdated
* Upgrades beyond Luminous must stop at Luminous.
* Jewel will be maintained until Mimic is released in the Spring of 2018.
* Kraken is no longer maintained.


Release numbers conventions
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Release numbering conventions

@liewegas
Copy link
Member Author

liewegas commented Oct 5, 2017

Moved the versioning scheme description earlier so the subsequent sections make sense.

@liewegas
Copy link
Member Author

liewegas commented Oct 5, 2017

@theanalyst How does this look to you?

doc/releases.rst Outdated
Subsequent development releases will be 9.0.1, 9.0.2, etc.
In the timeline, the life time of a stable release series is
calculated to be approximately 18 months after the month of the first
release. The lifetime of a release may vary because it depends on how
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe mention that this is because, we maintain backport releases for 2 release cycles, ie, Luminous will be maintained until the first stable release of Nautilus

Signed-off-by: Sage Weil <sage@redhat.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
7 participants