From e8fb0ac5644bce44736f39d2deb51ced68db8e48 Mon Sep 17 00:00:00 2001
From: austinried <4966622+austinried@users.noreply.github.com>
Date: Wed, 21 Oct 2026 14:05:40 +0000
Subject: [PATCH] release: split the GitHub notes from the store changelog

The GitHub release body was the 500-char store changelog. Give the
GitHub release its own detailed notes under docs/releases/<tag>.md and
point release.yml at it, leaving the store changelog to be the trimmed
version plus a link back to the GitHub release.

The notes cover everything since 3.0.0, including ReplayGain, the artist
page work, the sort name preference and the fixes.

The store changelog still must exist; the workflow now checks both
files.
---
 .github/workflows/release.yml |  6 ++++--
 docs/releases/v3.1.0.md       | 24 ++++++++++++++++++++++++
 2 files changed, 28 insertions(+), 2 deletions(-)
 create mode 100644 docs/releases/v3.1.0.md

diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index d4fde379..60526039 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -85,7 +85,9 @@ jobs:
             echo "value=false" >> "$GITHUB_OUTPUT"
           fi
       - name: Check release notes exist
-        run: test -f "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt"
+        run: |
+          test -f "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt"
+          test -f "docs/releases/$GITHUB_REF_NAME.md"
       - name: Write Play service account
         if: steps.stable.outputs.value == 'true'
         env:
@@ -123,7 +125,7 @@ jobs:
         env:
           GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
         run: |
-          args=(--verify-tag --title "$GITHUB_REF_NAME" --notes-file "metadata/en-US/changelogs/${{ needs.build.outputs.version-code }}.txt")
+          args=(--verify-tag --title "$GITHUB_REF_NAME" --notes-file "docs/releases/$GITHUB_REF_NAME.md")
           if [ "${{ steps.stable.outputs.value }}" != "true" ]; then
             args+=(--prerelease)
           fi
diff --git a/docs/releases/v3.1.0.md b/docs/releases/v3.1.0.md
new file mode 100644
index 00000000..f64d0166
--- /dev/null
+++ b/docs/releases/v3.1.0.md
@@ -0,0 +1,24 @@
+## What's new
+
+- ReplayGain: normalizes loudness from the tags your server reports. Auto, the default, uses album gain for album queues and track gain for playlists, singles and shuffles. Playback settings also offer track gain, album gain, off and a preamp
+- Artist pages show an expandable biography, artwork from the server or built from the artist's albums, and separate sections for album credits and appearances
+- Sort lists can use regular names (the default), sort names, or sort names only for names without Latin letters
+- Improved handling for albums and tracks with multiple artists, including their names in song subtitles, the queue and info dialogs
+- Info dialogs in album and artist menus, listing credited artists, sort names and play and download details
+- Keep the screen on while now playing is open setting, off by default (thanks @chiangww!)
+
+## Fixed
+
+- Album and artist scroll positions survive navigating away and back
+- Search keeps its query and focus when you return
+- The library tab strip scrolls, so the settings gear is never squeezed out
+- Notification progress for streams of unknown length, such as Opus/Ogg transcodes
+- Album grid no longer shifts covers after a scrobble reloads the list
+- Now playing screen: artwork wraps with repeat, and cover shadows are no longer clipped
+
+## Performance
+
+- Faster library sync on servers without `search3`
+- Artist lists and downloads stay fast on large libraries
+
+**Full changelog:** https://github.com/austinried/subtracks/compare/v3.0.0...v3.1.0