This is documentation for the next version of Loki. For the latest stable release, go to the latest version.
Prepare Release notes
Release notes are the few key highlights of the release. This is what appears on the release page on Github.
Before you begin
Determine the VERSION_PREFIX.
The release notes process for Grafana Loki works as follows.
We have two separate markdown files:
release-notes/next.mdto track release notes that are not released yet.
release-notes/v<major>-<minor>.mdto track release notes that are part of each specific Loki version.
Preparing release notes for a specific Loki release at high level is basically two steps:
- Add important notes to
- And make it available in a specific Loki version.
Discuss with Loki team to finalize what PRs should be part of release notes.
Go to the PR and add a label
add-to-release-notes. Example PR with label added.
Pick any one PR if the changes involves multiple PRs.
The CI process creates a PR to add the original PR to the release notes. Example PR.
Review the PR carefully. Update the description, approve and merge.
Repeat the steps for all the PRs.
Review the final release notes with Loki squad.
Create a release notes PR on the
mainbranch. Example PR.
next.mdfile to the new file
- Replace version place holders
V<MAJOR>.<MINOR>in the new file.
- Remove all the entries under
Features and enhancements,
- Add an entry for the new version in
_index.mdas shown in the example PR above. Set the weight for the new file so that the new release notes file appears at the top of the table of contents.
- Get the PR reviewed and merged.
Backport the release notes PR from
release-VERSION_PREFIXbranch. Example PR.