From ad8278ac433d9dc4530fdb73220f78c2a6d09555 Mon Sep 17 00:00:00 2001
From: 7hr08ik <7hr08ik@gmail.com>
Date: Sun, 9 Aug 2026 22:06:42 +0100
Subject: [PATCH] docs: describe the rebuild task's two phases

The task now refreshes the affected series after reassigning the
episodes, so the notes explain why both phases exist: reassigning an
episode does not create the season it now belongs to, and stopping after
the first phase leaves the previous seasons standing empty. Also notes
that progress runs 90% episodes then 10% seasons, so the run should be
allowed to reach 100%, and what a failed series refresh looks like.

Note: AI Generated Commit
---
 RELEASE_NOTES.md | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/RELEASE_NOTES.md b/RELEASE_NOTES.md
index 8adb567..d8a2934 100644
--- a/RELEASE_NOTES.md
+++ b/RELEASE_NOTES.md
@@ -123,10 +123,15 @@ a brand-new library.
 **Dashboard → Scheduled Tasks → Rebuild playlist seasons → run manually.**
 
 The task clears each episode's stored season number in libraries matching the configured collection
-title, then refreshes them so the current setting decides the season afresh. It works in both
+title, then refreshes them so the current setting decides the season afresh. It finishes by
+refreshing the affected series, which is what rebuilds the seasons themselves. It works in both
 directions: enabling the setting regroups a year-based library by playlist, and disabling it returns
 episodes to upload-year seasons.
 
+Both phases matter. Reassigning an episode does not create the season it now belongs to, so without
+the second phase the library shows the previous seasons standing empty. Progress reflects this: the
+first 90% is the episodes, the remainder is the seasons. Let it reach 100%.
+
 It has no automatic trigger. Regrouping a library is disruptive enough that it should happen when you
 choose, not as a side effect of saving a settings page.
 
@@ -137,6 +142,9 @@ seasons left behind. Jellyfin removes the now-empty old seasons by itself.
 Season *names* may briefly read "Season Unknown" immediately afterwards. That is a cached field on
 the episode and the next library refresh restores the correct name.
 
+If a series does fail to refresh, an error naming it is logged and the remaining series still run.
+That series keeps its old seasons, which appear empty; a library scan corrects it.
+
 **If you keep `.nfo` files next to your media, they win.** An `.nfo` containing `<season>` is a local
 metadata source, and Jellyfin prefers it over anything this plugin supplies, so those episodes stay
 where the file says regardless of the setting or the task. Measured: an episode with