From 8ac2d1f7bccfb265378888ec265304922154c90b Mon Sep 17 00:00:00 2001
From: mbastian77 <michael.bastian@visop.de>
Date: Sat, 18 Jul 2026 10:08:55 +0200
Subject: Add XML docs to small model enums and remove CS1591 suppressions

---
 .../Configuration/ImageSavingConvention.cs               | 12 ++++++++++--
 MediaBrowser.Model/Dto/IHasServerId.cs                   |  7 ++++++-
 MediaBrowser.Model/Dto/MediaSourceType.cs                | 16 ++++++++++++++--
 MediaBrowser.Model/Dto/RatingType.cs                     | 12 ++++++++++--
 MediaBrowser.Model/Library/PlayAccess.cs                 | 12 ++++++++++--
 MediaBrowser.Model/LiveTv/DayPattern.cs                  | 16 ++++++++++++++--
 MediaBrowser.Model/LiveTv/LiveTvServiceStatus.cs         | 12 ++++++++++--
 MediaBrowser.Model/MediaInfo/TransportStreamTimestamp.cs | 16 ++++++++++++++--
 8 files changed, 88 insertions(+), 15 deletions(-)

(limited to 'MediaBrowser.Model')

diff --git a/MediaBrowser.Model/Configuration/ImageSavingConvention.cs b/MediaBrowser.Model/Configuration/ImageSavingConvention.cs
index 485a4d2f80..c67f379fde 100644
--- a/MediaBrowser.Model/Configuration/ImageSavingConvention.cs
+++ b/MediaBrowser.Model/Configuration/ImageSavingConvention.cs
@@ -1,10 +1,18 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Configuration
 {
+    /// <summary>
+    /// The convention used for naming saved images.
+    /// </summary>
     public enum ImageSavingConvention
     {
+        /// <summary>
+        /// The legacy naming convention.
+        /// </summary>
         Legacy,
+
+        /// <summary>
+        /// The naming convention compatible with other media servers and metadata managers.
+        /// </summary>
         Compatible
     }
 }
diff --git a/MediaBrowser.Model/Dto/IHasServerId.cs b/MediaBrowser.Model/Dto/IHasServerId.cs
index c754d276c5..49452d736a 100644
--- a/MediaBrowser.Model/Dto/IHasServerId.cs
+++ b/MediaBrowser.Model/Dto/IHasServerId.cs
@@ -1,10 +1,15 @@
 #nullable disable
-#pragma warning disable CS1591
 
 namespace MediaBrowser.Model.Dto
 {
+    /// <summary>
+    /// Interface for DTOs that reference the id of the server they originate from.
+    /// </summary>
     public interface IHasServerId
     {
+        /// <summary>
+        /// Gets the server id.
+        /// </summary>
         string ServerId { get; }
     }
 }
diff --git a/MediaBrowser.Model/Dto/MediaSourceType.cs b/MediaBrowser.Model/Dto/MediaSourceType.cs
index 42314d5198..ca6649e64b 100644
--- a/MediaBrowser.Model/Dto/MediaSourceType.cs
+++ b/MediaBrowser.Model/Dto/MediaSourceType.cs
@@ -1,11 +1,23 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Dto
 {
+    /// <summary>
+    /// The type of a media source.
+    /// </summary>
     public enum MediaSourceType
     {
+        /// <summary>
+        /// A default media source.
+        /// </summary>
         Default = 0,
+
+        /// <summary>
+        /// A grouping of media sources.
+        /// </summary>
         Grouping = 1,
+
+        /// <summary>
+        /// A placeholder media source, for example a disc that has to be inserted.
+        /// </summary>
         Placeholder = 2
     }
 }
diff --git a/MediaBrowser.Model/Dto/RatingType.cs b/MediaBrowser.Model/Dto/RatingType.cs
index 033776f9c6..2c2b7b705d 100644
--- a/MediaBrowser.Model/Dto/RatingType.cs
+++ b/MediaBrowser.Model/Dto/RatingType.cs
@@ -1,10 +1,18 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Dto
 {
+    /// <summary>
+    /// The type of a community rating.
+    /// </summary>
     public enum RatingType
     {
+        /// <summary>
+        /// The rating is a numeric score.
+        /// </summary>
         Score,
+
+        /// <summary>
+        /// The rating is based on likes.
+        /// </summary>
         Likes
     }
 }
diff --git a/MediaBrowser.Model/Library/PlayAccess.cs b/MediaBrowser.Model/Library/PlayAccess.cs
index a2f263ce54..22daaf7254 100644
--- a/MediaBrowser.Model/Library/PlayAccess.cs
+++ b/MediaBrowser.Model/Library/PlayAccess.cs
@@ -1,10 +1,18 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.Library
 {
+    /// <summary>
+    /// The play access of an item.
+    /// </summary>
     public enum PlayAccess
     {
+        /// <summary>
+        /// The item can be played.
+        /// </summary>
         Full = 0,
+
+        /// <summary>
+        /// The item cannot be played.
+        /// </summary>
         None = 1
     }
 }
diff --git a/MediaBrowser.Model/LiveTv/DayPattern.cs b/MediaBrowser.Model/LiveTv/DayPattern.cs
index 17efe39088..dab69e8974 100644
--- a/MediaBrowser.Model/LiveTv/DayPattern.cs
+++ b/MediaBrowser.Model/LiveTv/DayPattern.cs
@@ -1,11 +1,23 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.LiveTv
 {
+    /// <summary>
+    /// The day pattern of a recurring timer.
+    /// </summary>
     public enum DayPattern
     {
+        /// <summary>
+        /// Every day.
+        /// </summary>
         Daily,
+
+        /// <summary>
+        /// Monday through Friday.
+        /// </summary>
         Weekdays,
+
+        /// <summary>
+        /// Saturday and Sunday.
+        /// </summary>
         Weekends
     }
 }
diff --git a/MediaBrowser.Model/LiveTv/LiveTvServiceStatus.cs b/MediaBrowser.Model/LiveTv/LiveTvServiceStatus.cs
index 72a0e2d7bf..a3df1dc411 100644
--- a/MediaBrowser.Model/LiveTv/LiveTvServiceStatus.cs
+++ b/MediaBrowser.Model/LiveTv/LiveTvServiceStatus.cs
@@ -1,10 +1,18 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.LiveTv
 {
+    /// <summary>
+    /// The status of a live TV service.
+    /// </summary>
     public enum LiveTvServiceStatus
     {
+        /// <summary>
+        /// The service is available.
+        /// </summary>
         Ok = 0,
+
+        /// <summary>
+        /// The service is unavailable.
+        /// </summary>
         Unavailable = 1
     }
 }
diff --git a/MediaBrowser.Model/MediaInfo/TransportStreamTimestamp.cs b/MediaBrowser.Model/MediaInfo/TransportStreamTimestamp.cs
index b7ee5747ab..1988dd8078 100644
--- a/MediaBrowser.Model/MediaInfo/TransportStreamTimestamp.cs
+++ b/MediaBrowser.Model/MediaInfo/TransportStreamTimestamp.cs
@@ -1,11 +1,23 @@
-#pragma warning disable CS1591
-
 namespace MediaBrowser.Model.MediaInfo
 {
+    /// <summary>
+    /// The type of timestamps used in a transport stream.
+    /// </summary>
     public enum TransportStreamTimestamp
     {
+        /// <summary>
+        /// The stream contains no timestamps.
+        /// </summary>
         None,
+
+        /// <summary>
+        /// The stream contains zero-value timestamps.
+        /// </summary>
         Zero,
+
+        /// <summary>
+        /// The stream contains valid timestamps.
+        /// </summary>
         Valid
     }
 }
-- 
cgit v1.2.3