minor logging and doc updates (#1130)

ErsatzTV.Application/Playouts/Commands/ReplacePlayoutAlternateScheduleItemsHandler.cs

@@ -151,6 +151,7 @@ public class ReplacePlayoutAlternateScheduleItemsHandler :
         }
         catch (Exception ex)
         {
+            _logger.LogError(ex, "Error saving alternate schedule items");
             return BaseError.New(ex.Message);
         }
     }

docs/user-guide/create-channels.md

@@ -40,6 +40,8 @@ Create a Schedule by navigating to the `Schedules` page, clicking `Add Schedule`
 
 * `Keep Multi-Part Episodes Together`: This only applies to shuffled schedule items, and will try to intelligently group multi-part episodes (i.e. `s05e02 - whatever part 1` and `s05e03 - whatever part 2`) so they are always scheduled together and always play in the correct order.
 * `Treat Collections As Shows`: This only applies when `Keep Multi-Part Episodes Together` is enabled, and will try to group multi-part episodes across shows within the collection (i.e. crossover episodes like `Show 1 - s03e04 - Whatever Part 1` and `Show 2 - s01e07 - Whatever Part 2`).
+* `Shuffle Schedule Items`: This shuffles the order of schedule items when building a playout, and is mostly used on channels with a mix of shows that require unique schedule item settings per show. Note that this disables fixed start times and flood mode.
+* `Random Start Point`: This starts each schedule item at a random place within the collection.
 
 ### Schedule Items
 
@@ -77,6 +79,7 @@ Select the desired playback order for media items within the selected collection
 - `Chronological`: Items are ordered by release date, then by season and episode number.
 - `Random`: Items are randomly ordered and may contain repeats.
 - `Shuffle`: Items are randomly ordered and no item will be played a second time until every item from the collection has been played once.
+- `Shuffle In Order`: Items are grouped (episodes by show, music videos by artist, one group for all movies), the group contents are sorted chronologically, and the groups are shuffled together while maintaining their individual chronological ordering.
 
 #### Playout Mode