clear up docu a bit

Author: LoneWandererProductions

Core.MemoryLog/IInMemoryLogger.cs

@@ -20,9 +20,7 @@ namespace Core.MemoryLog
     /// </summary>
     public interface IInMemoryLogger
     {
-        // ---------------------------------------------------------
-        // Configuration
-        // ---------------------------------------------------------
+        // --- Configuration ---
 
         /// <summary>
         /// Gets or sets the minimum log level for this logger.
@@ -35,15 +33,14 @@ public interface IInMemoryLogger
 
         /// <summary>
         /// Gets or sets a value indicating whether [enable stack trace].
+        /// Should be always false in production, as it can be expensive to capture stack traces for every log entry.
         /// </summary>
         /// <value>
         ///   <c>true</c> if [enable stack trace]; otherwise, <c>false</c>.
         /// </value>
         bool EnableStackTrace { get; set; }
 
-        // ---------------------------------------------------------
-        // Core logging
-        // ---------------------------------------------------------
+        // --- Core logging ---
 
         /// <summary>
         /// Adds a log entry to the memory (this can be directly from logging operations).
@@ -63,9 +60,7 @@ void Log(LogLevel logLevel,
             [CallerMemberName] string callerMethod = "",
             params object[] args);
 
-        // ---------------------------------------------------------
-        // Retrieval
-        // ---------------------------------------------------------
+        // --- Retrieval ---
 
         /// <summary>
         /// Gets all logs from memory.
@@ -97,9 +92,7 @@ void Log(LogLevel logLevel,
         /// </summary>
         event EventHandler<LogEntry>? LogAdded;
 
-        // ---------------------------------------------------------
-        // Persistence
-        // ---------------------------------------------------------
+        // --- Persistence ---
 
         /// <summary>
         /// Dumps the in-memory logs to a file.
@@ -109,9 +102,7 @@ void Log(LogLevel logLevel,
         /// <param name="minimumLevel">Minimum level to include in the dump.</param>
         void DumpToFile(string filePath, bool append = false, LogLevel minimumLevel = LogLevel.Trace);
 
-        // ---------------------------------------------------------
-        // Clearing
-        // ---------------------------------------------------------
+        // --- Clearing ---
 
         /// <summary>
         /// Clears log entries from a specific library.

Core.MemoryLog/ILogger.cs

@@ -17,19 +17,17 @@ namespace Core.MemoryLog
     /// </summary>
     public interface ILogger
     {
-        // ---------------------------------------------------------
+
         // Configuration
-        // ---------------------------------------------------------
+
 
         /// <summary>
         /// Gets or sets the minimum log level for this logger.
         /// Messages below this level will be ignored.
         /// </summary>
         LogLevel LogLevel { get; set; }
 
-        // ---------------------------------------------------------
-        // Core logging
-        // ---------------------------------------------------------
+        // --- Core logging ---
 
         /// <summary>
         /// Logs a message with the specified <paramref name="level"/>.
@@ -40,9 +38,7 @@ public interface ILogger
         /// <param name="args">Optional arguments for message formatting.</param>
         void Log(LogLevel level, string? message, Exception? exception = null, params object[] args);
 
-        // ---------------------------------------------------------
-        // Convenience shortcuts
-        // ---------------------------------------------------------
+        // --- Convenience shortcuts ---
 
         /// <summary>
         /// Logs the debug.
@@ -79,9 +75,7 @@ public interface ILogger
         /// <param name="args">The arguments.</param>
         void LogError(string? message, params object[] args);
 
-        // ---------------------------------------------------------
-        // Optional Microsoft.Extensions.Logging bridge
-        // ---------------------------------------------------------
+        // --- Optional Microsoft.Extensions.Logging bridge ---
 
         /// <summary>
         /// Bridges to Microsoft.Extensions.Logging infrastructure.
@@ -92,9 +86,7 @@ void Log<TState>(Microsoft.Extensions.Logging.LogLevel logLevel,
             Exception? exception,
             Func<TState, Exception?, string> formatter);
 
-        // ---------------------------------------------------------
-        // Persistence
-        // ---------------------------------------------------------
+        // --- Persistence ---
 
         /// <summary>
         /// Writes the current log entries to a file.

Core.MemoryLog/InMemoryLogger.cs

@@ -60,18 +60,9 @@ private InMemoryLogger() : this(1000) { }
         public LogLevel LogLevel { get; set; }
 
         /// <inheritdoc />
-        /// <summary>
-        /// Gets or sets a value indicating whether [enable stack trace].
-        /// </summary>
-        /// <value>
-        ///   <c>true</c> if [enable stack trace]; otherwise, <c>false</c>.
-        /// </value>
-        public bool EnableStackTrace { get; set; }
+        public bool EnableStackTrace { get; set; } = false;
 
         /// <inheritdoc />
-        /// <summary>
-        /// Occurs when [log added].
-        /// </summary>
         public event EventHandler<LogEntry>? LogAdded;
 
         /// <summary>
@@ -104,10 +95,6 @@ private void EnqueueLog(string library, LogEntry entry)
         }
 
         /// <inheritdoc />
-        /// <summary>
-        /// Core structured logging method.
-        /// Stores the original template and args without formatting.
-        /// </summary>
         public void Log(LogLevel level,
             string? message,
             string? libraryName = null,
@@ -152,9 +139,6 @@ public void Log(LogLevel level,
         }
 
         /// <inheritdoc />
-        /// <summary>
-        /// Default ILogger log (uses "ILogger" as library).
-        /// </summary>
         public void Log(LogLevel level, string? message, Exception? exception = null, params object[] args)
             => Log(
                 level,