Skip to content

Commit

Permalink
Merge pull request galaxyproject#17680 from dannon/release-management…
Browse files Browse the repository at this point in the history
…-doc

Addition of release process doc
  • Loading branch information
dannon authored May 16, 2024
2 parents d0f15e8 + f2317ad commit 8adfb7e
Showing 1 changed file with 69 additions and 0 deletions.
69 changes: 69 additions & 0 deletions doc/source/project/releases.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
======================
Galaxy Release Process
======================

This document outlines the Galaxy release cycle so administrators and users know
when to expect updates and what each update includes, making it easier to plan
for upgrades and maintain their systems. It does not cover the actual execution
of the release process, which is covered `elsewhere <https://docs.galaxyproject.org/en/master/dev/create_release.html>`__.


Major or Long Term Support (LTS) Releases
-----------------------------------------

As of 23.0, the first release of each year is Galaxy's annual LTS release. The
LTS release is a major version update corresponding to the year, for example,
24.0. This release receives significant and thorough end-to-end testing by a
dedicated team and will be supported and receive bugfixes until the next LTS.
As such, this release is ideally targeted for production use by local Galaxy
administrators.


Minor Releases
--------------

Throughout the year, we also ship several (usually 2-3) minor releases. These
are version updates like 24.1, 24.2. These can also include significant
updates, new features, etc. and follow the same release-testing protocol
as with the LTS release. These are targeted for administrators who want to stay
up to date with the latest features and improvements. Usegalaxy.org deploys new
minor releases as a part of the release process.


Point Releases
--------------

Point releases (e.g. 24.1.1) are issued to address bug fixes and security
updates. These are not scheduled and are released as needed. Following the
release branch (i.e. release_24.0) is recommended to stay up to date with these.


Release Schedule
----------------

Our release schedule is as follows:

- LTS Release: Annually, in the first quarter.
- Minor Releases: usually 2-3 times a year, generally in the early summer and fall.
- Point Releases: As needed.

Please note that the release dates can vary based on the development process and
testing results.

The usegalaxy.* public servers will be updated to the latest release within 90
business days of the release date.


Release Notes
-------------

For every release, we provide release notes that detail:

- Exciting new features
- General enhancements
- Bug fixes
- Datatype, Visualization, and Tool updates
- Administration Notes including configuration changes and migration guides if
applicable

Please refer to the release notes for detailed information about each release.

0 comments on commit 8adfb7e

Please sign in to comment.