XGBoost Release Policy
Versioning Policy
Starting from XGBoost 1.0.0, each XGBoost release will be versioned as [MAJOR].[FEATURE].[MAINTENANCE]
MAJOR: We guarantee the API compatibility across releases with the same major version number. We expect to have a 1+ years development period for a new MAJOR release version.
FEATURE: We ship new features, improvements and bug fixes through feature releases. The cycle length of a feature is decided by the size of feature roadmap. The roadmap is decided right after the previous release.
MAINTENANCE: Maintenance version only contains bug fixes. This type of release only occurs when we found significant correctness and/or performance bugs and barrier for users to upgrade to a new version of XGBoost smoothly.
Making a Release
Create an issue for the release, noting the estimated date and expected features or major fixes, pin that issue.
Bump release version.
Modify
CMakeLists.txt
in source tree andcmake/Python_version.in
if needed, run CMake.Modify
DESCRIPTION
in R-package.Run
change_version.sh
injvm-packages/dev
Commit the change, create a PR on GitHub on release branch. Port the bumped version to default branch, optionally with the postfix
SNAPSHOT
.Create a tag on release branch, either on GitHub or locally.
Make a release on GitHub tag page, which might be done with previous step if the tag is created on GitHub.
Submit pip, CRAN, and Maven packages.
The pip package is maintained by Hyunsu Cho and Jiaming Yuan. There’s a helper script for downloading pre-built wheels and R packages
xgboost/dev/release-pypi-r.py
along with simple instructions for usingtwine
.The CRAN package is maintained by Tong He and Jiaming Yuan.
Before submitting a release, one should test the package on R-hub and win-builder first. Please note that the R-hub Windows instance doesn’t have the exact same environment as the one hosted on win-builder.
The Maven package is maintained by Nan Zhu and Hyunsu Cho.