Doc improvements

Author: nblumhardt

src/SeqCli/Config/RuntimeConfigurationLoader.cs

@@ -11,8 +11,8 @@ static class RuntimeConfigurationLoader
     const string DefaultEnvironmentVariablePrefix = "SEQCLI_";
 
     /// <summary>
-    /// This is the method to use when loading configuration for runtime use. It will apply overrides from the
-    /// secret store and environment, and validate the configuration.
+    /// This is the method to use when loading configuration for runtime use. It will read the default configuration
+    /// file, if any, and apply overrides from the environment.
     /// </summary>
     public static SeqCliConfig Load()
     {

src/SeqCli/Config/SeqCliConfig.cs

@@ -35,6 +35,11 @@ class SeqCliConfig
         }
     };
 
+    /// <summary>
+    /// Loads <paramref name="filename"/> without considering any environment overrides, nor performing any validation.
+    /// This method is typically used when editing/manipulating the configuration file itself. To read and use the
+    /// configuration at runtime, see <see cref="RuntimeConfigurationLoader.Load"/>.
+    /// </summary>
     public static SeqCliConfig ReadFromFile(string filename)
     {
         var content = File.ReadAllText(filename);