[106] Merge remote-tracking branch 'chazlarson/patch-2' into nightly

docs/defaults/separators.md

@@ -8,6 +8,10 @@ Below is an example of a separator, which can be seen surrounded by a red square
 
 ![](images/separators.jpg)
 
+## Important Note:
+
+Plex does not support creating these empty collections natively through its UI, so they can behave strangely in some cases, primarily related to showing/hiding them in the main library view.  As a workaround, you can use a `placeholder_` [template variable](#shared-separator-variables) to specify a single movie/show to add to these collections so they have one thing in them and will then behave as expected.  For example, `placeholder_imdb_id: tt0068646` will place The Godfather inside the separator in a movie library.
+
 ## Separator Files
 
 These are all the files that contain a separator 
@@ -49,9 +53,9 @@ Note that the `template_variables:` section only needs to be used if you do want
 | `sep_style`              | **Description:** Choose the [Separator Style](#separator-styles).<br>**Default:** `orig`<br>**Values:** `amethyst`, `aqua`, `blue`, `forest`, `fuchsia`, `gold`, `gray`, `green`, `navy`, `ocean`, `olive`, `orchid`, `orig`, `pink`, `plum`, `purple`, `red`, `rust`, `salmon`, `sand`, `stb`, or `tan`                                                                           |         
 | `sort_prefix`            | **Description:** Changes the prefix of the sort title.<br>**Default:** `!`<br>**Values:** Any String                                                                                                                                                                                                                                                                                  |
 | `sort_title`             | **Description:** Changes the sort title of all collections.<br>**Default:** `<<sort_prefix>><<collection_section>>_!<<title>>`<br>**Values:** Any String                                                                                                                                                                                                                              |
-| `placeholder_tmdb_movie` | **Description:** Add a placeholder Movie to the Separator.<br>**Values:** TMDb Movie ID                                                                                                                                                                                                                                                                                               |
-| `placeholder_tvdb_show`  | **Description:** Add a placeholder Show to the Separator.<br>**Values:** TVDb Show ID                                                                                                                                                                                                                                                                                                 |
-| `placeholder_imdb_id`    | **Description:** Add a placeholder Movie/Show to the Separator.<br>**Values:** IMDb ID                                                                                                                                                                                                                                                                                                |
+| `placeholder_tmdb_movie` | **Description:** Add a placeholder Movie to the Separator.  Only valid for Movie libraries.<br>**Values:** TMDb Movie ID                                                                                                                                                                                                                                                              |
+| `placeholder_tvdb_show`  | **Description:** Add a placeholder Show to the Separator.  Only valid for Show libraries.<br>**Values:** TVDb Show ID                                                                                                                                                                                                                                                                 |
+| `placeholder_imdb_id`    | **Description:** Add a placeholder Movie/Show to the Separator.  Valid for Movie or Show libraries assuming the ID points to an item of the correct type.<br>**Values:** IMDb ID                                                                                                                                                                                                      |
 | `name_separator`         | **Description:** Changes the name of the specified key's collection.<br>**Values:** New Collection Name                                                                                                                                                                                                                                                                               |
 | `summary_separator`      | **Description:** Changes the summary of the specified key's collection.<br>**Values:** New Collection Summary                                                                                                                                                                                                                                                                         |
 | `collection_section`     | **Description:** Changes the sort order of the collection sections against other default collection sections.<br>**Values:** Any number                                                                                                                                                                                                                                               |