Documentation tweaks

Author: dehesa

README.md

@@ -584,31 +584,6 @@ struct Student: Codable {
 
 > Using integer coding keys has the added benefit of better encoder/decoder performance. By explicitly indicating the field index, you let the decoder skip the functionality of matching coding keys string values to headers.
 
-To generate type-safe name header rows you can use an enum with `String` rawValues.
-
-```swift
-struct Student: Codable {
-    var name: String
-    var age: Int
-    var hasPet: Bool
-
-    private enum CodingKeys: String, CodingKey, CaseIterable {
-        case name = "name"
-        case age = "age"
-        case hasPet = "hasPet"
-    }
-}
-```
-
-Then configure your encoder with explicit headers.
-
-```swift
-let encoder = CSVEncoder {
-    $0.headers = Student.CodingKeys.allCases.map({ $0.rawValue })
-}
-```
-
-
 </p></details>
 <details><summary>A CSV is a long list of rows/records.</summary><p>
 
@@ -758,6 +733,32 @@ decoder.nilStrategy = .custom({ (encoder) in
 
 </p></details>
 
+<details><summary>Type-safe headers row.</summary><p>
+
+You can generate type-safe name headers using Swift introspection tools (i.e. `Mirror`) or explicitly defining the `CodingKey` enum with `String` raw value conforming to `CaseIterable`.
+
+```swift
+struct Student {
+    var name: String
+    var age: Int
+    var hasPet: Bool
+
+    enum CodingKeys: String, CodingKey, CaseIterable {
+        case name, age, hasPet
+    }
+}
+```
+
+Then configure your encoder with explicit headers.
+
+```swift
+let encoder = CSVEncoder {
+    $0.headers = Student.CodingKeys.allCases.map { $0.rawValue }
+}
+```
+
+</p></details>
+
 <details><summary>Performance advices.</summary><p>
 
 #warning("TODO:")

sources/imperative/reader/ReaderConfiguration.swift

@@ -16,9 +16,6 @@ extension CSVReader {
         /// Trims the given characters at the beginning and end of each row, and between fields.
         public var trimStrategy: CharacterSet
         /// Boolean indicating whether the data/file/string should be completely parsed at reader's initialization.
-        ///
-        /// Setting this property to `true` samples the data/file/string at initialization time. This process returns some interesting data such as blob/file size, full-file encoding validation, etc.
-        /// The _presample_ process will however hurt performance since it iterates over all the data in initialization.
         public var presample: Bool
 
         /// Designated initializer setting the default values.