RUMM-3151 docs updates

Sources/Datadog/DatadogCore/Storage/Writing/FileWriter.swift

@@ -20,7 +20,11 @@ internal struct FileWriter: Writer {
 
     // MARK: - Writing data
 
-    /// Encodes given value to JSON data and writes it to the file.
+    /// Encodes given encodable value and metadata, and writes it to the file.
+    /// If encryption is available, the data is encrypted before writing.
+    /// - Parameters:
+    ///  - value: Encodable value to write.
+    ///  - metadata: Encodable metadata to write.
     func write<T: Encodable, M: Encodable>(value: T, metadata: M?) {
         do {
             let encodedValue = try encode(encodable: value, blockType: .event)

Sources/Datadog/DatadogCore/Storage/Writing/Writer.swift

@@ -8,10 +8,16 @@ import Foundation
 
 /// A type, writing data.
 public protocol Writer {
+    /// Encodes given encodable value and metadata, and writes to the destination.
+    /// - Parameter value: Encodable value to write.
+    /// - Parameter metadata: Encodable metadata to write.
     func write<T: Encodable, M: Encodable>(value: T, metadata: M?)
 }
 
 extension Writer {
+    /// Encodes given encodable value and writes to the destination.
+    /// Uses `write(value:metadata:)` with `nil` metadata.
+    /// - Parameter value: Encodable value to write.
     public func write<T: Encodable>(value: T) {
         let metadata: Data? = nil
         write(value: value, metadata: metadata)