docs: add comment about options

Flash0ver · Flash0ver · commit 5136730782eb · 2025-09-24T13:57:23.000+02:00
diff --git a/src/Sentry.Serilog/SentrySink.cs b/src/Sentry.Serilog/SentrySink.cs
@@ -165,6 +165,9 @@ private void InnerEmit(LogEvent logEvent)
                 level: logEvent.Level.ToBreadcrumbLevel());
         }
 
+        // Read the options from the Hub, rather than the Sink's Serilog-Options, because 'EnableLogs' is declared in the base 'SentryOptions', rather than the derived 'SentrySerilogOptions'.
+        // In cases where Sentry's Serilog-Sink is added without a DSN (i.e., without initializing the SDK) and the SDK is initialized differently (e.g., through ASP.NET Core),
+        // then the 'EnableLogs' option of this Sink's Serilog-Options is default, but the Hub's Sentry-Options have the actual user-defined value configured.
         var options = hub.GetSentryOptions();
         if (options?.Experimental.EnableLogs is true)
         {

Original file line number	Diff line number	Diff line change
`@@ -165,6 +165,9 @@ private void InnerEmit(LogEvent logEvent)`
`165`	`165`	`level: logEvent.Level.ToBreadcrumbLevel());`
`166`	`166`	`}`
`167`	`167`
	`168`	`+ // Read the options from the Hub, rather than the Sink's Serilog-Options, because 'EnableLogs' is declared in the base 'SentryOptions', rather than the derived 'SentrySerilogOptions'.`
	`169`	`+ // In cases where Sentry's Serilog-Sink is added without a DSN (i.e., without initializing the SDK) and the SDK is initialized differently (e.g., through ASP.NET Core),`
	`170`	`+ // then the 'EnableLogs' option of this Sink's Serilog-Options is default, but the Hub's Sentry-Options have the actual user-defined value configured.`
`168`	`171`	`var options = hub.GetSentryOptions();`
`169`	`172`	`if (options?.Experimental.EnableLogs is true)`
`170`	`173`	`{`