2019-01-03 01:16:34 +03:00
---
title: Steps to a Successful Release
2019-12-11 12:49:28 +03:00
category: Contributing
2019-12-11 19:01:46 +03:00
layout: default
2021-09-14 17:05:21 +03:00
SPDX-License-Identifier: LGPL-2.1-or-later
2019-01-03 01:16:34 +03:00
---
2018-11-29 13:09:09 +03:00
# Steps to a Successful Release
2016-05-31 20:43:41 +03:00
1. Add all items to NEWS
2022-04-12 13:05:53 +03:00
2. Update the contributors list in NEWS (`ninja -C build git-contrib`)
2016-05-31 20:43:41 +03:00
3. Update the time and place in NEWS
2022-04-12 13:05:53 +03:00
4. Update hwdb (`ninja -C build update-hwdb update-hwdb-autosuspend`)
2021-03-17 18:26:13 +03:00
5. [RC1] Update version and library numbers in `meson.build`
2022-04-12 13:05:53 +03:00
6. Check dbus docs with `ninja -C build update-dbus-docs`
2021-03-17 18:26:13 +03:00
7. Tag the release: `version=vXXX-rcY && git tag -s "${version}" -m "systemd ${version}"`
2022-04-12 13:05:53 +03:00
8. Do `ninja -C build`
2021-03-17 18:26:13 +03:00
9. Make sure that the version string and package string match: `build/systemctl --version`
2022-04-12 13:05:53 +03:00
10. Upload the documentation: `ninja -C build doc-sync`
2021-03-17 18:26:13 +03:00
11. [FINAL] Close the github milestone and open a new one (https://github.com/systemd/systemd/milestones)
12. "Draft" a new release on github (https://github.com/systemd/systemd/releases/new), mark "This is a pre-release" if appropriate.
13. Check that announcement to systemd-devel, with a copy& paste from NEWS, was sent. This should happen automatically.
14. Update IRC topic (`/msg chanserv TOPIC #systemd Version NNN released`)
2021-12-23 23:25:31 +03:00
15. [FINAL] Push commits to stable, create an empty -stable branch: `git push systemd-stable --atomic origin/main:main origin/main:refs/heads/${version}-stable` , and change the default branch to latest release (https://github.com/systemd/systemd-stable/settings/branches).