Skip to content

docs: cover the season view frontier rule and the SPORTARR_NET variable - #166

Merged
enoch85 merged 1 commit into
mainfrom
docs/drift-163
Aug 30, 2026
Merged

docs: cover the season view frontier rule and the SPORTARR_NET variable#166
enoch85 merged 1 commit into
mainfrom
docs/drift-163

Conversation

@enoch85

@enoch85 enoch85 commented Aug 29, 2026

Copy link
Copy Markdown
Collaborator

Closes #163.

What was added

Doc Edit Upstream
Glossary.md Plex.sw_lastViewedAtThroughSeason entry Maintainerr#3531 (3cc3d5de)
Glossary.md Jellyfin.sw_lastViewedAtThroughSeason entry, naming Emby Maintainerr#3531 (c65327b3)
Rules.mdx The property in the watch-history block Maintainerr#3531
MediaServerSwitching.md A property that migrates can still answer differently on the new server Maintainerr#3531
Installation.mdx SPORTARR_NET row in the environment variable table 12d0e26d, 67bb265e
API.md Metadata refresh takes sportarr alongside tmdb and tvdb 129d1049
Security.md TELEMETRY=off also hides the consent prompt Maintainerr#3605 (4501c380)

Already covered by prior PRs

Drift item Covered by
Sportarr league matching and the tvdb alias #164
Sportarr artwork source and SPORTARR_NET behaviour #164
Refresh Metadata in the Sportarr server dialog #164
Sportarr rule properties (15 keys, all documented) earlier
Notification rate-limit wait, already described as one wait up to a minute #151

Corrections to the report

  • Emby has the property too. rules.constants.ts builds the Emby application in the constructor from jellyfinApp.props, and the drift parser only reads app blocks in the literal array, so it reports no Emby keys for this rule or any other. The Glossary documents no Emby. keys either, so the two stay consistent.
  • 870b1e93 is listed under behavioural fixes but was reverted on the same branch by 06095411, so nothing was written for it. The shipped rule does let a deleted season's view carry forward, deliberately.
  • Three items the report does not surface: the new SPORTARR_NET variable, the third member of the metadata provider enum, and the telemetry prompt change.

Rule-key parity checked against a local clone of development: no keys missing in either direction. npm run format and npm run build are clean.

Maintainerr#3531 adds sw_lastViewedAtThroughSeason, a season-only date
property answering with the newest view across the season and every season
before it. The Glossary gains an entry under Plex and one under Jellyfin,
and Rules.mdx gains a paragraph beside the lastPlayedAt one.

Plex and Jellyfin/Emby compute it from different sources, so both entries
say which: Plex reads its retained show history and counts views of
episodes that have since left the library, while Jellyfin and Emby walk the
episodes the show holds at the time of the run. The property still migrates
directly between all three, since the id and the name match on each, so
Media Server Switching gains a line saying a property that migrates can
still answer differently on the new server.

Emby has the property too. Its application is built at runtime from
Jellyfin's property list, so it is named in the Jellyfin entry rather than
given a section of its own, which is how the Glossary already treats every
other Emby property.

Three more the drift report did not list. SPORTARR_NET is described under
Sportarr in Configuration but missing from the Installation environment
variable table, which claims to list them all. Maintainerr#3605 stopped the
telemetry prompt appearing at all while TELEMETRY=off, where Security still
described a prompt that returns until it is answered. And the metadata
refresh endpoint in API.md takes sportarr alongside tmdb and tvdb, since
the provider enum it validates against gained a third member.
@enoch85
enoch85 merged commit 5039a80 into main Aug 30, 2026
3 checks passed
@enoch85
enoch85 deleted the docs/drift-163 branch August 30, 2026 13:35
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Docs drift - updates needed for the next Maintainerr release

1 participant