From ca1f96d2c2ef22d4917a3a60364e949ac546082f Mon Sep 17 00:00:00 2001
From: Dean Herbert <pe@ppy.sh>
Date: Mon, 6 Dec 2021 13:03:11 +0900
Subject: [PATCH] Reword xmldoc of `MultiplayerPlaylistItem.PlaylistOrder` to
 better match actual behaviour

---
 osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
index 1c33b79531..cee6d8fe41 100644
--- a/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
+++ b/osu.Game/Online/Rooms/MultiplayerPlaylistItem.cs
@@ -40,8 +40,12 @@ namespace osu.Game.Online.Rooms
         public bool Expired { get; set; }
 
         /// <summary>
-        /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played, starting from 0 and increasing for items which will be played later.
+        /// The order in which this <see cref="MultiplayerPlaylistItem"/> will be played relative to others.
+        /// Playlist items should be played in increasing order (lower values are played first).
         /// </summary>
+        /// <remarks>
+        /// This is only valid for items which are not <see cref="Expired"/>. The value for expired items is undefined and should not be used.
+        /// </remarks>
         [Key(8)]
         public ushort PlaylistOrder { get; set; }