mirror of
https://github.com/loot/loot.github.io.git
synced 2026-07-27 14:13:30 -07:00
62 lines
3.0 KiB
HTML
62 lines
3.0 KiB
HTML
---
|
|
layout: page
|
|
title: Making A Release
|
|
weight: 2
|
|
aliases:
|
|
- Making-A-Release.html
|
|
---
|
|
|
|
<h3>Releasing libloot</h3>
|
|
|
|
<h4>Prepare</h4>
|
|
|
|
<ol>
|
|
<li>Update the version numbers by running <code>python scripts/set_version_number.py <version></code>.</li>
|
|
<li>Make sure that the version histories in <code>docs/api/changelog.rst</code> and <code>docs/metadata/changelog.rst</code> are up to date for the new release and that its release date is set.
|
|
</ol>
|
|
|
|
<h4>Release</h4>
|
|
|
|
<ol>
|
|
<li>Tag the commit and push the tag to GitHub.</li>
|
|
<li>Activate the tag's documentation version <a href="https://readthedocs.org/dashboard/loot-api/versions/">on Read The Docs</a> if it is not automatically activated.
|
|
</ol>
|
|
|
|
<h3>Releasing LOOT</h3>
|
|
|
|
<h4>Prepare</h4>
|
|
|
|
<ol>
|
|
<li>Update the version numbers by running <code>python scripts/set_version_number.py <version></code>.</li>
|
|
<li>Make sure that the version history in <code>docs/app/changelog.rst</code> is up to date for the new release and that its release date is set.
|
|
<li>Add the release to the <releases> element in <code>resources/linux/io.github.loot.loot.metainfo.xml</code>.</li>
|
|
</ol>
|
|
|
|
<p>If the new release makes metadata syntax changes:</p>
|
|
<ol>
|
|
<li>Run <a href="https://github.com/loot/lomad">lomad</a> using <code>lomad -t <github personal access token> -a -b <branch name></code> to (for all masterlists) create a branch for that release.</li>
|
|
<li>Update the default masterlist branch value and add the old value to <code>OLD_DEFAULT_BRANCHES</code> in <code>src/gui/state/loot_settings.cpp</code>.</li>
|
|
<li>Update the <b>Repository branch</b> setting in the <a href="https://hosted.weblate.org/settings/loot/prelude/#vcs">Version control tab</a> of the settings page for the LOOT masterlist prelude on Weblate.</li>
|
|
</ol>
|
|
|
|
<h4>Release</h4>
|
|
|
|
<ol>
|
|
<li>Tag the commit and push the tag to GitHub.</li>
|
|
<li>Once the tag's GitHub Actions release workflow has completed, publish the draft release that it created.</li>
|
|
<li>Activate the tag's documentation version <a href="https://readthedocs.org/dashboard/loot/versions/">on Read The Docs</a> if it is not automatically activated.
|
|
</ol>
|
|
|
|
<h4>Update Flathub</h4>
|
|
|
|
<ol>
|
|
<li>Update <a href="https://github.com/flathub/io.github.loot.loot/blob/master/io.github.loot.loot.yml"><code>io.github.loot.loot.yml</code></a> in the <code>flathub/io.github.loot.loot</code> GitHub repository to match the <code>resources/linux/io.github.loot.loot.yml</code> file in the <code>loot/loot</code> GitHub repository, except that the LOOT release archive should be downloaded from the LOOT release published on GitHub.</li>
|
|
<li>Open a pull request to merge the changes into the <code>master</code> branch, and merge it.</li>
|
|
</ol>
|
|
|
|
<p>See the <a href="https://docs.flathub.org/docs/for-app-authors/maintanance">Flathub documentation</a> for details on how Flathub builds and publishes changes.</p>
|
|
|
|
<h4>Port Metadata</h4>
|
|
|
|
<p>Be sure to merge post-branching metadata changes that were made in the masterlists' old default branches into the new default branches.</p>
|