observatory herald (#30)

* WIP: initial commit for observatory herald

* Plugin error handling refactor

* make error window non-modal

* tidy up plugin error handling

* first pass for basic herald functionality

* corrections for linux env

* Use FNV hash directly instead of managing through dictionary/index file

* resolve audio queuing issue, switch to personal NetCoreAudio fork

* merge cleanup

* add enable setting, populate defaults

* framework xml doc update

* Adjust settings, add style selection, replace locale with demonym in dropdown list.

* Test is position is on screen before saving/loading.

* use a default that's actually in the list

ObservatoryFramework/Files/ShipyardFile.cs

@@ -3,13 +3,35 @@ using System.Collections.Immutable;
 
 namespace Observatory.Framework.Files
 {
+    /// <summary>
+    /// Elite Dangerous shipyard.json file.
+    /// </summary>
     public class ShipyardFile : Journal.JournalBase
     {
+        /// <summary>
+        /// Unique ID of market.
+        /// </summary>
         public long MarketID { get; init; }
+        /// <summary>
+        /// Name of station where shipyard is located.
+        /// </summary>
         public string StationName { get; init; }
+        /// <summary>
+        /// Starsystem where shipyard is located.
+        /// </summary>
         public string StarSystem { get; init; }
+        /// <summary>
+        /// Whether player has access to Horizons content.
+        /// </summary>
         public bool Horizons { get; init; }
+        /// <summary>
+        /// <para>Whether player has access to the Cobra MkIV.</para>
+        /// <para>Will never be set to true for CMDR Nuse.</para>
+        /// </summary>
         public bool AllowCobraMkIV { get; init; }
+        /// <summary>
+        /// List of all ships and prices for them at the current shipyard.
+        /// </summary>
         public ImmutableList<ShipyardPrice> PriceList { get; init; }
     }
 }