diff --git a/RELEASING.md b/RELEASING.md new file mode 100644 index 00000000..541ae39a --- /dev/null +++ b/RELEASING.md @@ -0,0 +1,57 @@ +# How to make a libxkbcommon release + +### Prerequisites + +- Have write access to xkbcommon Git repositories. +- Be subscribed to the [wayland-devel](https://lists.freedesktop.org/mailman/listinfo/wayland-devel) mailing list. + +### Steps + +#### Prepare the release + +- Update the `NEWS.md` file for the release, following [the corresponding instructions](changes/README.md). + +- Bump the `version` in `meson.build`. + +- Run `meson dist -C build` to make sure the release is good to go. + +- Commit `git commit -m 'Bump version to MAJOR.MINOR.PATCH'`. + +- Tag `git tag --anotated -m xkbcommon- xkbcommon-`. + +- Push `git push --follow-tags`. + +#### Send announcement email to wayland-devel + +Send an email to the wayland-devel@lists.freedesktop.org mailing list, using this template: + +``` +Subject: [ANNOUNCE] libxkbcommon MAJOR.MINOR.PATCH + + + +Git tag: +-------- + +git tag: xkbcommon- + + +``` + +#### Update website + +- Pull the latest [website repository](https://github.com/xkbcommon/website). + +- Add the doc for the release: `cp -r /build/html doc/`. + +- Update the `current` symlink: `ln -nsrf doc/ doc/current`. + +- Grab a link to the announcement mail from the [wayland-devel archives](https://lists.freedesktop.org/archives/wayland-devel/). + +- Update the `index.html`: + - "Our latest API- and ABI-stable release ..." + - Add entry to the `releases` HTML list. + +- Commit `git commit -m MAJOR.MINOR.PATCH`. + +- Push `git push`. This automatically publishes the website after a few seconds.