Improve docs

lib/datadog/core/telemetry/event.rb

@@ -393,14 +393,20 @@ def type
             'logs'
           end
 
+          # @param message [String] the log message
+          # @param level [Symbol, String] the log level. Either :error, :warn, 'ERROR', or 'WARN'.
+          # @param stack_trace [String, nil] the stack trace
+          # @param count [Integer] the number of times the log was emitted. Used for deduplication.
           def initialize(message:, level:, stack_trace: nil, count: 1)
             super()
             @message = message
             @stack_trace = stack_trace
 
             if level.is_a?(String) && LEVELS_STRING.include?(level)
+              # String level is used during object copy for deduplication
               @level = level
             elsif level.is_a?(Symbol)
+              # Symbol level is used by the regular log emitter user
               @level = LEVELS.fetch(level) { |k| raise ArgumentError, "Invalid log level :#{k}" }
             else
               raise ArgumentError, "Invalid log level #{level}"

lib/datadog/core/telemetry/worker.rb

@@ -170,9 +170,9 @@ def disable_on_not_found!(response)
           disable!
         end
 
-        # Deduplicate all_logs by counting the number of occurrences of each log
-        # entry and replacing them with a single entry with the count.
-        # Other events are passed through unchanged.
+        # Deduplicate logs by counting the number of repeated occurrences of the same log
+        # entry and replacing them with a single entry with the calculated `count` value.
+        # Non-log events are unchanged.
         def deduplicate_logs(events)
           return events if events.empty?