Cleanup: comments.

Author: oscbyspro

Sources/DiffableTextStylesXNumeric/Number/Glyph.swift

@@ -13,13 +13,13 @@ import Foundation
 // MARK: * Glyph
 //*============================================================================*
 
-/// An object representing an ASCII character by its UTF8 value.
+/// An object representing an UTF-8 encoded ASCII character.
 ///
-/// - The conforming object MUST be a struct.
+/// - The conforming object MUST be a struct (have a bit pattern equal to its rawValue).
 ///
 @usableFromInline protocol Glyph: Hashable, CaseIterable, CustomStringConvertible {
     associatedtype Enumeration: CaseIterable, RawRepresentable where Enumeration.RawValue == UInt8
-    
+
     //=------------------------------------------------------------------------=
     // MARK: State
     //=------------------------------------------------------------------------=

Sources/DiffableTextStylesXNumeric/Number/Glyphs.swift

@@ -11,14 +11,14 @@
 // MARK: * Glyphs
 //*============================================================================*
 
-/// An object representing multiple ASCII characters by their UTF8 values.
+/// An object representing multiple UTF-8 encoded ASCII characters.
 @usableFromInline protocol Glyphs: CustomStringConvertible {
 
     //=------------------------------------------------------------------------=
     // MARK: Conversions
     //=------------------------------------------------------------------------=
 
-    /// Returns the ASCII representation of this instance as UTF8 encoded bytes.
+    /// Returns its UTF-8 encoded ASCII representation.
     @inlinable var rawValue: [UInt8] { get }
 }
 
@@ -32,7 +32,7 @@ extension Glyphs {
     // MARK: Characters / Description
     //=------------------------------------------------------------------------=
 
-    /// Returns the ASCII representation of this instance as a String.
+    /// Returns its ASCII representation.
     @inlinable var description: String {
         String(bytes: rawValue, encoding: .utf8)!
     }