doc: added tutorials for helper and dynamic decoding/encoding (#64)

Author: soumyamahunt

.github/config/spellcheck-wordlist.txt

@@ -9,7 +9,10 @@ HelperCoders
 JSON
 LossySequenceCoder
 Codable
+Encodable
+Decodable
 MetaCodable
+MetaProtocolCodable
 Midbin
 README
 Refactorings
@@ -56,3 +59,6 @@ enums
 conformances
 Podfile
 cocoapods
+DocumentationExtension
+mergeBehavior
+lowercasing

Sources/HelperCoders/Base64Coder.swift

@@ -1,7 +1,7 @@
 import Foundation
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
+/// An `HelperCoder` that helps decoding/encoding
 /// base64 data.
 ///
 /// This type can be used to decode/encode base64 data
@@ -12,7 +12,7 @@ public struct Base64Coder: HelperCoder {
     /// The options to use when encoding data.
     private let encodeOptions: Data.Base64EncodingOptions
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// base64 data.
     ///
     /// - Parameters:

Sources/HelperCoders/ConditionalCoder.swift

@@ -1,76 +1,76 @@
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
-/// with two separate ``/MetaCodable/HelperCoder``s.
+/// An `HelperCoder` that helps decoding/encoding
+/// with two separate `HelperCoder`s.
 ///
-/// This type can be used to use separate ``/MetaCodable/HelperCoder``s
+/// This type can be used to use separate `HelperCoder`s
 /// for decoding and encoding.
 public struct ConditionalCoder<D: HelperCoder, E: HelperCoder>: HelperCoder
 where D.Coded == E.Coded {
-    /// The ``/MetaCodable/HelperCoder`` used for decoding.
+    /// The `HelperCoder` used for decoding.
     @usableFromInline
     internal let decoder: D
-    /// The ``/MetaCodable/HelperCoder`` used for encoding.
+    /// The `HelperCoder` used for encoding.
     @usableFromInline
     internal let encoder: E
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// conditionally with provided decoder/encoder respectively.
     ///
     /// The provided decoder is used only for decoding
     /// and encoder only for encoding.
     ///
     /// - Parameters:
-    ///   - decoder: The ``/MetaCodable/HelperCoder`` used for decoding.
-    ///   - encoder: The ``/MetaCodable/HelperCoder`` used for encoding.
+    ///   - decoder: The `HelperCoder` used for decoding.
+    ///   - encoder: The `HelperCoder` used for encoding.
     public init(decoder: D, encoder: E) {
         self.decoder = decoder
         self.encoder = encoder
     }
 
-    /// Decodes using the decode specific ``/MetaCodable/HelperCoder``
+    /// Decodes using the decode specific `HelperCoder`
     /// from the given `decoder`.
     ///
     /// - Parameter decoder: The decoder to read data from.
     /// - Returns: The decoded value.
-    /// - Throws: If the underlying ``/MetaCodable/HelperCoder`` throws error.
+    /// - Throws: If the underlying `HelperCoder` throws error.
     @inlinable
     public func decode(from decoder: Decoder) throws -> D.Coded {
         return try self.decoder.decode(from: decoder)
     }
 
     /// Decodes optional value using the decode specific
-    /// ``/MetaCodable/HelperCoder`` from the given `decoder`.
+    /// `HelperCoder` from the given `decoder`.
     ///
     /// - Parameter decoder: The decoder to read data from.
     /// - Returns: The decoded optional value.
-    /// - Throws: If the underlying ``/MetaCodable/HelperCoder`` throws error.
+    /// - Throws: If the underlying `HelperCoder` throws error.
     @inlinable
     public func decodeIfPresent(from decoder: Decoder) throws -> D.Coded? {
         return try self.decoder.decodeIfPresent(from: decoder)
     }
 
-    /// Encodes using the encode specific ``/MetaCodable/HelperCoder``
+    /// Encodes using the encode specific `HelperCoder`
     /// from the given `encoder`.
     ///
     /// - Parameters:
     ///   - value: The value to encode.
     ///   - encoder: The encoder to write data to.
     ///
-    /// - Throws: If the underlying ``/MetaCodable/HelperCoder`` throws error.
+    /// - Throws: If the underlying `HelperCoder` throws error.
     @inlinable
     public func encode(_ value: E.Coded, to encoder: Encoder) throws {
         try self.encoder.encode(value, to: encoder)
     }
 
     /// Encodes optional value using the encode specific
-    /// ``/MetaCodable/HelperCoder`` from the given `encoder`.
+    /// `HelperCoder` from the given `encoder`.
     ///
     /// - Parameters:
     ///   - value: The value to encode.
     ///   - encoder: The encoder to write data to.
     ///
-    /// - Throws: If the underlying ``/MetaCodable/HelperCoder`` throws error.
+    /// - Throws: If the underlying `HelperCoder` throws error.
     @inlinable
     public func encodeIfPresent(_ value: E.Coded?, to encoder: Encoder) throws {
         try self.encoder.encodeIfPresent(value, to: encoder)

Sources/HelperCoders/DateCoders/DateCoder.swift

@@ -8,7 +8,7 @@ import MetaCodable
 /// represented in **ISO 8601** text format.
 public typealias ISO8601DateCoder = DateCoder<ISO8601DateFormatter>
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
+/// An `HelperCoder` that helps decoding/encoding
 /// formatted date representation.
 ///
 /// This type can be used to decode/encode dates
@@ -18,7 +18,7 @@ public struct DateCoder<Formatter: DateFormatConverter>: HelperCoder {
     @usableFromInline
     internal let formatter: Formatter
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// formatted date representation.
     ///
     /// Created instance can be used to decode/encode dates
@@ -29,7 +29,7 @@ public struct DateCoder<Formatter: DateFormatConverter>: HelperCoder {
         self.formatter = formatter
     }
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// **ISO 8601** formatted date representation.
     ///
     /// Created instance can be used to decode/encode dates

Sources/HelperCoders/DateCoders/Since1970DateCoder.swift

@@ -1,7 +1,7 @@
 import Foundation
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
+/// An `HelperCoder` that helps decoding/encoding
 /// UNIX timestamp.
 ///
 /// This type can be used to decode/encode dates
@@ -47,7 +47,7 @@ public struct Since1970DateCoder: HelperCoder {
     @usableFromInline
     internal let type: IntervalType
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// UNIX timestamp.
     ///
     /// Created instance can be used to decode/encode dates

Sources/HelperCoders/HelperCoders.docc/HelperCoders.md

@@ -4,7 +4,7 @@
     @Available(swift, introduced: "5.9")
 }
 
-Level up ``/MetaCodable``'s generated implementations with helpers assisting common decoding/encoding requirements.
+Level up `MetaCodable`'s generated implementations with helpers assisting common decoding/encoding requirements.
 
 ## Overview
 

Sources/HelperCoders/NonConformingCoder.swift

@@ -1,6 +1,6 @@
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
+/// An `HelperCoder` that helps decoding/encoding
 /// non-confirming floating point values.
 ///
 /// This type can be used to decode/encode exceptional
@@ -14,7 +14,7 @@ where Float: FloatingPoint & Codable & LosslessStringConvertible {
     /// The value representing not-a-number.
     private let nan: String
 
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// exceptional floating-point values matching provided
     /// string representations.
     ///

Sources/HelperCoders/PropertyWrapperCoder.swift

@@ -1,13 +1,13 @@
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding
+/// An `HelperCoder` that helps decoding/encoding
 /// using existing property wrappers.
 ///
 /// This type can be used to reuse existing property
 /// wrappers with custom decoding/encoding with
-/// ``/MetaCodable`` generated implementations.
+/// `MetaCodable` generated implementations.
 public struct PropertyWrapperCoder<Wrapper: PropertyWrappable>: HelperCoder {
-    /// Creates a new instance of ``/MetaCodable/HelperCoder`` that decodes/encodes
+    /// Creates a new instance of `HelperCoder` that decodes/encodes
     /// using existing property wrappers.
     ///
     /// - Returns: A new property wrapper based decoder/encoder.

Sources/HelperCoders/SequenceCoder/DefaultSequenceElementCoding.swift

@@ -1,6 +1,6 @@
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that performs default decoding/encoding.
+/// An `HelperCoder` that performs default decoding/encoding.
 ///
 /// This type doesn't provide any customization and used only to opt out of
 /// decoding/encoding customizations.

Sources/HelperCoders/SequenceCoder/SequenceCoder.swift

@@ -1,19 +1,19 @@
 import MetaCodable
 
-/// An ``/MetaCodable/HelperCoder`` that helps decoding/encoding sequence.
+/// An `HelperCoder` that helps decoding/encoding sequence.
 ///
 /// This type tries to decode and encode a sequence according to provided
-/// ``Configuration-swift.struct`` and element ``/MetaCodable/HelperCoder``.
+/// ``Configuration-swift.struct`` and element `HelperCoder`.
 ///
 /// `DefaultSequenceElementCoding` can be used as element
-/// ``/MetaCodable/HelperCoder``, if on configuration based.
+/// `HelperCoder`, if on configuration based.
 /// decoding/encoding needed
 public struct SequenceCoder<Sequence, ElementHelper>: HelperCoder
 where
     Sequence: SequenceInitializable, ElementHelper: HelperCoder,
     Sequence.Element == ElementHelper.Coded
 {
-    /// The ``/MetaCodable/HelperCoder`` for element.
+    /// The `HelperCoder` for element.
     ///
     /// Each element is decoded/encoded using this.
     public let elementHelper: ElementHelper
@@ -28,7 +28,7 @@ where
     ///
     /// - Parameters:
     ///   - output: The resulting sequence type.
-    ///   - elementHelper: The ``/MetaCodable/HelperCoder`` for element.
+    ///   - elementHelper: The `HelperCoder` for element.
     ///   - configuration: The configuration for decoding and encoding.
     public init(
         output: Sequence.Type, elementHelper: ElementHelper,
@@ -43,7 +43,7 @@ where
     /// Sequence type is inferred from provided configuration.
     ///
     /// - Parameters:
-    ///   - elementHelper: The ``/MetaCodable/HelperCoder`` for element.
+    ///   - elementHelper: The `HelperCoder` for element.
     ///   - configuration: The configuration for decoding and encoding.
     public init(
         elementHelper: ElementHelper, configuration: Configuration
@@ -92,7 +92,7 @@ where
     /// By default, no additional customizations configuration is used.
     ///
     /// - Parameters:
-    ///   - elementHelper: The ``/MetaCodable/HelperCoder`` for element.
+    ///   - elementHelper: The `HelperCoder` for element.
     ///   - configuration: The configuration for decoding and encoding.
     public init(
         elementHelper: ElementHelper, configuration: Configuration = .init()