This is the repository for the openSUSE release notes.
If you are looking for an online version of the release notes, see the documentation server.
To learn how to contribute, read on...
- Make sure you can explain what is wrong or why a new entry is needed.
- Before proposing a release notes entry about a concerns a software bug, make sure that the software bug itself is reported on Bugzilla.
Getting the Change In
If you see an issue or want to add an entry, you can contribute in two ways:
Create a bug report. You will need an openSUSE account to do so.
- Make sure to mention the affected openSUSE version.
- If you are proposing a new entry, create a draft entry.
Create a pull request on GitHub. You will need a GitHub account to do so.
- Edit the file
xml/release-notes.xmlonly. Language (PO) files are edited using Weblate and the file
NEWSis updated only directly before packaging.
- Make sure to pick the right branch to base your contribution on.
masteris used for openSUSE Tumbleweed release notes,
Leap_*branches are used for openSUSE Leap versions. Usually, the default branch will be the current development version of openSUSE Leap.
- If you are writing a new release note which was requested in a Bugzilla entry, append the bug number to your Git commit message. For example: "Add note on Barfoosation of Frob (boo#12345)"
- If you are making a larger change which was not requested via Bugzilla,
add a line containing only an asterisk character (
*) after the normal commit message. This way, the commit message will be picked up for
NEWSand the package change log later.
- Edit the file
To translate openSUSE release notes, use Weblate.
- Task runner:
- Building documentation output:
- Translation import:
When the above dependencies are satisfied, you can create output using:
make linguas make all
Build Service Build
- On the build service, search for the package
release-notes-openSUSE. This package contains everything you need to get the release notes to build on OBS.
- The release notes are available packaged within the distribution and on the Web.
- The name of package is
- The package is throughout the maintenance period of the distribution whenever need arises.
- The web version is built in the OBS Project Documentation:Auto.
- It is synced to the documentation server
using the scripts contained in the directory
toolsin this repository's
Find general information about the release notes at https://en.opensuse.org/openSUSE:Release_Notes.