added documentaion comments.

Signed-off-by: Matt Bruce <matt.bruce@verizon.com>

VDS/Classes/Control.swift

@@ -16,7 +16,6 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
     //--------------------------------------------------
     // MARK: - Combine Properties
     //--------------------------------------------------
-    /// Set of Subscribers for any Publishers for this Control.
     open var subscribers = Set<AnyCancellable>()
 
     open var onClickSubscriber: AnyCancellable? {
@@ -32,12 +31,10 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
     //--------------------------------------------------
     private var initialSetupPerformed = false
     
-    /// Key of whether or not updateView() is called in setNeedsUpdate()
     open var shouldUpdateView: Bool = true
     
     open var userInfo = [String: Primitive]()
     
-    /// Current Surface and this is used to pass down to child objects that implement Surfacable
     open var surface: Surface = .light { didSet { setNeedsUpdate() } }
     
     /// Whether the Control is selected or not.
@@ -50,7 +47,7 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
     
     var isHighlightAnimating = false
     
-    /// Whether the Control is highlighted or not..
+    /// Whether the Control is highlighted or not.
     open override var isHighlighted: Bool {
         didSet {
             if canHighlight && isHighlightAnimating == false && touchUpInsideCount > 0 {
@@ -113,7 +110,6 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
         insetsLayoutMarginsFromSafeArea = false
     }
             
-    /// Function used to make changes to the View based off a change events or from local properties.
     open func updateView() { }
     
     open func updateAccessibility() {
@@ -131,7 +127,6 @@ open class Control: UIControl, ViewProtocol, UserInfoable, Clickable {
 
     }
     
-    /// Resets to default settings.
     open func reset() {
         backgroundColor = .clear
         surface = .light

VDS/Classes/SelectorBase.swift

@@ -11,10 +11,19 @@ import VDSColorTokens
 import VDSFormControlsTokens
 
 public protocol SelectorControlable: Control, Changeable {
+    /// Whether not to show the error.
     var showError: Bool { get set }
+    
+    /// Size of the SelectorView.
     var size: CGSize { get set }
+    
+    /// Configuration for the Background Color based on Control State.
     var backgroundColorConfiguration: ControlColorConfiguration { get set }
+
+    /// Configuration for the Border Color based on Control State.
     var borderColorConfiguration: ControlColorConfiguration { get set }
+
+    /// Configuration for the Selector Color based on Control State.
     var selectorColorConfiguration: ControlColorConfiguration { get set }
 }
 
@@ -41,6 +50,7 @@ open class SelectorBase: Control, SelectorControlable {
         }
     }
     
+    /// Override UIControl state to add the .error state if showError is true.
     open override var state: UIControl.State {
         get {
             var state = super.state
@@ -68,6 +78,7 @@ open class SelectorBase: Control, SelectorControlable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize { size }
 
     open override func initialSetup() {
@@ -77,6 +88,7 @@ open class SelectorBase: Control, SelectorControlable {
         }
     }
     
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
         
@@ -84,13 +96,14 @@ open class SelectorBase: Control, SelectorControlable {
         accessibilityTraits = .button
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         setNeedsLayout()
         layoutIfNeeded()
     }
     
+    /// Used to update any Accessibility properties.ß
     open override func updateAccessibility() {
         super.updateAccessibility()
     }

VDS/Classes/SelectorGroupHandlerBase.swift

@@ -19,7 +19,6 @@ open class SelectorGroupHandlerBase<HandlerType: Control>: Control, Changeable {
     /// Array of the HandlerType registered.
     open var selectorViews: [HandlerType] = []
             
-    /// The primary subscriber for onChange or the UIControl valueChanged event.
     open var onChangeSubscriber: AnyCancellable? {
         willSet {
             if let onChangeSubscriber {
@@ -28,14 +27,13 @@ open class SelectorGroupHandlerBase<HandlerType: Control>: Control, Changeable {
         }
     }
         
-    /// Whether this object is enabled or not
     override open var isEnabled: Bool {
         didSet {
             selectorViews.forEach { $0.isEnabled = isEnabled }
         }
     }
     
-    /// Current Surface and this is used to pass down to child objects that implement Surfacable.
+    ///The background tint that the component will be placed on. This will automatically adjust other elements as needed and takes “light” or “dark”
     override open var surface: Surface {
         didSet {
             selectorViews.forEach { handler in
@@ -61,12 +59,13 @@ open class SelectorGroupHandlerBase<HandlerType: Control>: Control, Changeable {
         }
     }
     
-    /// Resets to default settings as well as child views.
+    /// Resets to default settings.
     open override func reset() {
         super.reset()
         selectorViews.forEach{ $0.reset() }
     }
     
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {        
         super.updateAccessibility()
         setAccessibilityLabel(for: selectorViews)

VDS/Classes/SelectorItemBase.swift

@@ -62,7 +62,6 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
     //--------------------------------------------------
     // MARK: - Public Properties
     //--------------------------------------------------
-    /// Subscriber that is set for the .valueChanged event.
     open var onChangeSubscriber: AnyCancellable? {
         willSet {
             if let onChangeSubscriber {
@@ -95,7 +94,6 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
     /// Generic Object used to allow the user to 'Select'.
     open var selectorView = Selector()
     
-    /// Whether or not ths Item is selected.
     open override var isSelected: Bool { didSet { setNeedsUpdate() }}
     
     /// Text shown in the label.
@@ -167,6 +165,7 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
         }
     }
 
+    /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     open override func setup() {
         super.setup()
 
@@ -184,7 +183,7 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
         mainStackView.pinToSuperView()
     }
             
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         updateLabels()
@@ -195,6 +194,7 @@ open class SelectorItemBase<Selector: SelectorControlable>: Control, Errorable,
         selectorView.surface = surface
     }
 
+    /// Used to update any Accessibility properties.
     open override func updateAccessibility() {
         super.updateAccessibility()
         setAccessibilityLabel(for: [label, childLabel, errorLabel])

VDS/Classes/SelfSizingCollectionView.swift

@@ -36,7 +36,7 @@ public final class SelfSizingCollectionView: UICollectionView {
     // MARK: - UIView
     //--------------------------------------------------
 
-    
+    /// The natural size for the receiving view, considering only properties of the view itself.
     public override var intrinsicContentSize: CGSize {
         let contentSize = self.contentSize
         //print(#function, contentSize)

VDS/Classes/View.swift

@@ -16,7 +16,6 @@ open class View: UIView, ViewProtocol, UserInfoable {
     //--------------------------------------------------
     // MARK: - Combine Properties
     //--------------------------------------------------
-    /// Set of Subscribers for any Publishers for this Control.
     open var subscribers = Set<AnyCancellable>()
     
     //--------------------------------------------------
@@ -24,16 +23,13 @@ open class View: UIView, ViewProtocol, UserInfoable {
     //--------------------------------------------------
     private var initialSetupPerformed = false
     
-    /// Key of whether or not updateView() is called in setNeedsUpdate()
     open var shouldUpdateView: Bool = true
     
     /// Dictionary for keeping information for this Control use only Primitives.
     open var userInfo = [String: Primitive]()
     
-    /// Current Surface and this is used to pass down to child objects that implement Surfacable
     open var surface: Surface = .light { didSet { setNeedsUpdate() } }
     
-    /// Whether the View is enabled or not.
     open var isEnabled: Bool = true { didSet { setNeedsUpdate() } }
     
     //--------------------------------------------------
@@ -67,18 +63,14 @@ open class View: UIView, ViewProtocol, UserInfoable {
        }
     }
     
-    /// Will be called only once and should be overridden in subclasses to setup UI or defaults.
     open func setup() {
         backgroundColor = .clear
         translatesAutoresizingMaskIntoConstraints = false
         insetsLayoutMarginsFromSafeArea = false
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties..
+    open func updateView() { }
-    open func updateView() {
-    }
     
-    /// Used to update any Accessibility properties.
     open func updateAccessibility() {
         if isEnabled {
             accessibilityTraits.remove(.notEnabled)
@@ -87,7 +79,6 @@ open class View: UIView, ViewProtocol, UserInfoable {
         }
     }
         
-    /// Resets to default settings.
     open func reset() {
         backgroundColor = .clear
         surface = .light

VDS/Components/Badge/Badge.swift

@@ -144,7 +144,7 @@ open class Badge: View {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/BadgeIndicator/BadgeIndicator.swift

@@ -306,7 +306,7 @@ open class BadgeIndicator: View {
         }
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Buttons/Button/Button.swift

@@ -50,6 +50,7 @@ open class Button: ButtonBase, Useable {
         textColorConfiguration.getColor(self)
     }
     
+    /// TextStyle used on the titleLabel.
     open override var textStyle: TextStyle {
         size == .large ? TextStyle.boldBodyLarge : TextStyle.boldBodySmall
     }
@@ -121,7 +122,7 @@ open class Button: ButtonBase, Useable {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     
     open override func setup() {
@@ -144,6 +145,7 @@ open class Button: ButtonBase, Useable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize {
         guard let width, width > 0 else {
             var superSize = super.intrinsicContentSize
@@ -154,7 +156,7 @@ open class Button: ButtonBase, Useable {
         return CGSize(width: width > size.minimumWidth ? width : size.minimumWidth, height: size.height)
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Buttons/Button/ButtonBase.swift

@@ -12,8 +12,14 @@ import VDSFormControlsTokens
 import Combine
 
 public protocol Buttonable: UIControl, Surfaceable, Enabling {
+    
+    /// The ButtonSize available to this type of Buttonable.
     var availableSizes: [ButtonSize] { get }
+        
+    /// The Text that will show up in the TitleLabel for this Buttonable.
     var text: String? { get set }
+    
+    /// The natural size for the receiving view, considering only properties of the view itself.
     var intrinsicContentSize: CGSize { get }
 }
 
@@ -51,16 +57,23 @@ open class ButtonBase: UIButton, Buttonable, ViewProtocol, UserInfoable, Clickab
     open var shouldUpdateView: Bool = true 
     
     open var availableSizes: [ButtonSize] { [] }
+    
+    open var surface: Surface = .light { didSet { setNeedsUpdate() }}
 
     open var text: String? { didSet { setNeedsUpdate() } }
     
+    /// Array of LabelAttributeModel objects used in rendering the text. 
     open var textAttributes: [any LabelAttributeModel]? { nil }
+    
+    /// TextStyle used on the titleLabel.
+    open var textStyle: TextStyle { .defaultStyle }
+    
+    /// UIColor used on the titleLabel text.
+    open var textColor: UIColor { .black }
 
+    /// Will determine if a scaled font should be used for the titleLabel font.
     open var useScaledFont: Bool = false { didSet { setNeedsUpdate() }}
-    
+        
-    /// Current Surface and this is used to pass down to child objects that implement Surfacable
-    open var surface: Surface = .light { didSet { setNeedsUpdate() }}
-    
     open var userInfo = [String: Primitive]()
 
     open var touchUpInsideCount: Int = 0
@@ -87,10 +100,6 @@ open class ButtonBase: UIButton, Buttonable, ViewProtocol, UserInfoable, Clickab
     /// Whether the Control is enabled or not.
     open override var isEnabled: Bool { didSet { setNeedsUpdate() } }
 
-    open var textStyle: TextStyle { .defaultStyle }
-    
-    open var textColor: UIColor { .black }
-
     //--------------------------------------------------
     // MARK: - Initializers
     //--------------------------------------------------
@@ -110,7 +119,7 @@ open class ButtonBase: UIButton, Buttonable, ViewProtocol, UserInfoable, Clickab
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     open func initialSetup() {
         if !initialSetupPerformed {
@@ -151,7 +160,7 @@ open class ButtonBase: UIButton, Buttonable, ViewProtocol, UserInfoable, Clickab
         return CGSize(width: adjustedWidth, height: adjustedHeight)
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open func updateView() {
         updateLabel()
     }

VDS/Components/Buttons/ButtonGroup/ButtonGroup.swift

@@ -125,7 +125,7 @@ open class ButtonGroup: View, UICollectionViewDataSource, UICollectionViewDelega
         super.init(coder: coder)
     }
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
 
     open override func setup() {
@@ -137,7 +137,7 @@ open class ButtonGroup: View, UICollectionViewDataSource, UICollectionViewDelega
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         positionLayout.position = buttonPosition

VDS/Components/Buttons/TextLink/TextLink.swift

@@ -34,6 +34,7 @@ open class TextLink: ButtonBase {
         size == .large ? TextStyle.bodyLarge : TextStyle.bodySmall
     }
         
+    /// UIColor used on the titleLabel text.
     open override var textColor: UIColor {
         textColorConfiguration.getColor(self)
     }
@@ -69,7 +70,7 @@ open class TextLink: ButtonBase {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     open override func setup() {
         super.setup()
@@ -103,11 +104,12 @@ open class TextLink: ButtonBase {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize {
         return titleLabel?.intrinsicContentSize ?? super.intrinsicContentSize
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         //need to set the properties so the super class
         //can render out the label correctly

VDS/Components/Buttons/TextLinkCaret/TextLinkCaret.swift

@@ -46,6 +46,7 @@ open class TextLinkCaret: ButtonBase {
         44
     }
         
+    /// UIColor used on the titleLabel text.
     open override var textColor: UIColor {
         textColorConfiguration.getColor(self)
     }
@@ -72,7 +73,7 @@ open class TextLinkCaret: ButtonBase {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     open override func setup() {
         super.setup()
@@ -89,12 +90,13 @@ open class TextLinkCaret: ButtonBase {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// The natural size for the receiving view, considering only properties of the view itself.
     override open var intrinsicContentSize: CGSize {
         //get the labels size, if not the button
         return titleLabel?.intrinsicContentSize ?? super.intrinsicContentSize
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         imageAttribute = CaretLabelAttribute(tintColor: textColor, position: iconPosition)
         super.updateView()

VDS/Components/Checkbox/CheckboxGroup.swift

@@ -120,8 +120,10 @@ extension CheckboxGroup {
         public var value: AnyHashable?
         public var accessibileText: String?
         public var labelText: String?
+        /// Array of LabelAttributeModel objects used in rendering the labeText.
         public var labelTextAttributes: [any LabelAttributeModel]?
         public var childText: String?
+        /// Array of LabelAttributeModel objects used in rendering the childText.
         public var childTextAttributes: [any LabelAttributeModel]?
         public var selected: Bool
         public var showError: Bool

VDS/Components/Checkbox/CheckboxItem.swift

@@ -44,7 +44,7 @@ open class CheckboxItem: SelectorItemBase<Checkbox> {
         sendActions(for: .valueChanged)
     }
         
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         selectorView.isAnimated = isAnimated
         super.updateView()

VDS/Components/Icon/ButtonIcon/ButtonIcon.swift

@@ -263,7 +263,7 @@ open class ButtonIcon: Control {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Icon/Icon.swift

@@ -71,11 +71,12 @@ open class Icon: View {
         imageView.image = nil
     }
     
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize {
         dimensions
     }
         
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         //get the color for the image

VDS/Components/Label/Attributes/ImageLabelAttribute.swift

@@ -52,7 +52,7 @@ public struct ImageLabelAttribute: AttachmentLabelAttributeModel {
     }
     
     //--------------------------------------------------
-    // MARK: - Private Functions
+    // MARK: - Private Methods
     //--------------------------------------------------
     private func imageAttachment(image: UIImage) -> NSTextAttachment {
         let attachment = NSTextAttachment()
@@ -70,7 +70,7 @@ public struct ImageLabelAttribute: AttachmentLabelAttributeModel {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     public func getAttachment() throws -> NSTextAttachment {
         

VDS/Components/Label/Attributes/LabelAttributeModel.swift

@@ -9,12 +9,19 @@ import Foundation
 import UIKit
 
 public protocol LabelAttributeModel: AnyEquatable, Withable, Equatable, Identifiable where ID == UUID {
+    /// Position of the starting point for this LabelAttribute.
     var location: Int { get set }
+    
+    /// Length from the location.
     var length: Int { get set }
+    
+    /// Applies the attribute to the attributedString that is given.
+    /// - Parameter attributedString: AttributedString that the attributed is applied.
     func setAttribute(on attributedString: NSMutableAttributedString)
 }
 
 extension LabelAttributeModel {
+    /// Range for this AttributeModel
     public var range: NSRange {
         NSRange(location: location, length: length)
     }

VDS/Components/Label/Attributes/UnderlineLabelAttribute.swift

@@ -50,7 +50,7 @@ public struct UnderlineLabelAttribute: LabelAttributeModel {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
    public func setAttribute(on attributedString: NSMutableAttributedString) {
         attributedString.addAttribute(.underlineStyle, value: underlineValue.rawValue, range: range)

VDS/Components/Label/Label.swift

@@ -34,8 +34,10 @@ open class Label: UILabel, ViewProtocol, UserInfoable {
     /// Current Surface and this is used to pass down to child objects that implement Surfacable
     open var surface: Surface = .light { didSet { setNeedsUpdate() }}
     
+    /// Array of LabelAttributeModel objects used in rendering the text. 
     open var attributes: [any LabelAttributeModel]? { didSet { setNeedsUpdate() }}
     
+    /// TextStyle used on the this label.
     open var textStyle: TextStyle = .defaultStyle  { didSet { setNeedsUpdate() }}
     
     open var edgeInsets: UIEdgeInsets { textStyle.edgeInsets }
@@ -85,7 +87,7 @@ open class Label: UILabel, ViewProtocol, UserInfoable {
     }
         
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     open func initialSetup() {
         if !initialSetupPerformed {
@@ -135,7 +137,7 @@ open class Label: UILabel, ViewProtocol, UserInfoable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open func updateView() {
         if !useAttributedText {
             if let text =  text {

VDS/Components/Line/Line.swift

@@ -43,6 +43,7 @@ open class Line: View {
     // MARK: - Overrides
     //--------------------------------------------------
     
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize {
         if orientation == .vertical {
             return .init(width: 1, height: bounds.height)
@@ -62,7 +63,7 @@ open class Line: View {
         super.setup()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
 

VDS/Components/Loader/Loader.swift

@@ -34,6 +34,7 @@ open class Loader: View {
         }
     }
     
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize { .init(width: size, height: size) }
     
     //--------------------------------------------------
@@ -55,7 +56,7 @@ open class Loader: View {
         ])
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         icon.color = iconColorConfiguration.getColor(self)

VDS/Components/Loader/LoaderViewController.swift

@@ -43,7 +43,7 @@ open class LoaderViewController: UIViewController, Surfaceable {
         updateView()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open func updateView() {
         view.backgroundColor = backgroundColorConfiguration.getColor(self).withAlphaComponent(0.8)
         if let size {

VDS/Components/Notification/Notification.swift

@@ -264,7 +264,7 @@ open class Notification: View {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/RadioBox/RadioBoxGroup.swift

@@ -115,10 +115,13 @@ extension RadioBoxGroup {
         public var value: AnyHashable?
         public var accessibileText: String?
         public var text: String
+        /// Array of LabelAttributeModel objects used in rendering the text.
         public var textAttributes: [any LabelAttributeModel]?
         public var subText: String?
+        /// Array of LabelAttributeModel objects used in rendering the subText.
         public var subTextAttributes: [any LabelAttributeModel]?
         public var subTextRight: String?
+        /// Array of LabelAttributeModel objects used in rendering the subTextRight. 
         public var subTextRightAttributes: [any LabelAttributeModel]?
         public var selected: Bool
         

VDS/Components/RadioBox/RadioBoxItem.swift

@@ -88,6 +88,7 @@ open class RadioBoxItem: Control, Changeable {
     
     open var text: String = "Default Text" { didSet { setNeedsUpdate() }}
 
+    /// Array of LabelAttributeModel objects used in rendering the text.
     open var textAttributes: [any LabelAttributeModel]? { didSet { setNeedsUpdate() }}
   
     open var textAttributedText: NSAttributedString? {
@@ -100,6 +101,7 @@ open class RadioBoxItem: Control, Changeable {
     
     open var subText: String? { didSet { setNeedsUpdate() }}
 
+    /// Array of LabelAttributeModel objects used in rendering the subText.
     open var subTextAttributes: [any LabelAttributeModel]? { didSet { setNeedsUpdate() }}
 
     open var subTextAttributedText: NSAttributedString? {
@@ -112,6 +114,7 @@ open class RadioBoxItem: Control, Changeable {
     
     open var subTextRight: String? { didSet { setNeedsUpdate() }}
 
+    /// Array of LabelAttributeModel objects used in rendering the subTextRight. 
     open var subTextRightAttributes: [any LabelAttributeModel]? { didSet { setNeedsUpdate() }}
 
     open var subTextRightAttributedText: NSAttributedString? {
@@ -259,7 +262,7 @@ open class RadioBoxItem: Control, Changeable {
         sendActions(for: .valueChanged)
     }
 
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/RadioButton/RadioButtonGroup.swift

@@ -124,8 +124,10 @@ extension RadioButtonGroup {
         public var value: AnyHashable?
         public var accessibileText: String?
         public var labelText: String?
+        /// Array of LabelAttributeModel objects used in rendering the labelText.
         public var labelTextAttributes: [any LabelAttributeModel]?
         public var childText: String?
+        /// Array of LabelAttributeModel objects used in rendering the childText. 
         public var childTextAttributes: [any LabelAttributeModel]?
         public var selected: Bool
         public var showError: Bool

VDS/Components/RadioSwatch/RadioSwatch.swift

@@ -125,7 +125,7 @@ open class RadioSwatch: Control {
         sendActions(for: .valueChanged)
     }
 
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/RadioSwatch/RadioSwatchGroup.swift

@@ -124,7 +124,7 @@ open class RadioSwatchGroup: SelectorGroupSelectedHandlerBase<RadioSwatch>, UICo
         collectionView.dataSource = self
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Tabs/Tab.swift

@@ -50,6 +50,7 @@ extension Tabs {
         //--------------------------------------------------
         // MARK: - Private Properties
         //--------------------------------------------------
+        /// TextStyle used on the label.
         private var textStyle: TextStyle {
             if size == .medium {
                 return .boldBodyLarge
@@ -145,7 +146,7 @@ extension Tabs {
             labelBottomConstraint = label.pinBottom(anchor: layoutGuide.bottomAnchor, priority: .defaultHigh)
         }
         
-        /// Function used to make changes to the View based off a change events or from local properties.
+        /// Used to make changes to the View based off a change events or from local properties.
         open override func updateView() {
             super.updateView()
             

VDS/Components/Tabs/Tabs.swift

@@ -201,7 +201,7 @@ open class Tabs: View {
         
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
 

VDS/Components/Tabs/TabsContainer.swift

@@ -135,7 +135,7 @@ open class TabsContainer: View {
         tabMenuLayoutGuide.pinToSuperView()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/TextFields/EntryField/EntryField.swift

@@ -135,6 +135,7 @@ open class EntryField: Control, Changeable {
     
     open var showError: Bool = false { didSet { setNeedsUpdate() }}
     
+    /// Override UIControl state to add the .error state if showError is true.
     open override var state: UIControl.State {
         get {
             var state = super.state
@@ -258,7 +259,7 @@ open class EntryField: Control, Changeable {
         readOnly = false
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/TextFields/InputField/InputField.swift

@@ -75,6 +75,7 @@ open class InputField: EntryField, UITextFieldDelegate {
         }
     }
         
+    /// Override UIControl state to add the .error state if showSuccess is true and if showError is true.
     open override var state: UIControl.State {
         get {
             var state = super.state
@@ -161,7 +162,7 @@ open class InputField: EntryField, UITextFieldDelegate {
         return inputFieldStackView
     }
 
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/TextFields/TextArea/TextArea.swift

@@ -91,7 +91,7 @@ open class TextArea: EntryField {
         return inputFieldStackView
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/TileContainer/TileContainer.swift

@@ -200,7 +200,7 @@ open class TileContainer: Control {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         
@@ -249,7 +249,7 @@ open class TileContainer: Control {
     }
     
     //--------------------------------------------------
-    // MARK: - Public Functions
+    // MARK: - Public Methods
     //--------------------------------------------------
     public func addContentView(_ view: UIView, shouldPin: Bool = true) {
         containerView.addSubview(view)
@@ -281,7 +281,7 @@ open class TileContainer: Control {
     }
 
     //--------------------------------------------------
-    // MARK: - Private Functions
+    // MARK: - Private Methods
     //--------------------------------------------------
     private func ratioSize(for width: CGFloat) -> CGSize {
         var height: CGFloat = width

VDS/Components/Tilelet/Tilelet.swift

@@ -365,7 +365,7 @@ open class Tilelet: TileContainer {
         }
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Tilelet/TileletSubTitleModel.swift

@@ -24,6 +24,7 @@ extension Tilelet {
         //--------------------------------------------------
         public var text: String = ""
         public var standardStyle: StandardStyle = .bodySmall
+        /// Array of LabelAttributeModel objects used in rendering the text. 
         public var textAttributes: [any LabelAttributeModel]?
         public var textColor: Use = .primary
         
@@ -41,7 +42,7 @@ extension Tilelet {
         }
         
         //--------------------------------------------------
-        // MARK: - Public Functions
+        // MARK: - Public Methods
         //--------------------------------------------------
         public func toTitleLockupSubTitleModel() -> TitleLockup.SubTitleModel {
             TitleLockup.SubTitleModel(text: text,

VDS/Components/Tilelet/TileletTitleModel.swift

@@ -24,6 +24,7 @@ extension Tilelet {
         // MARK: - Public Properties
         //--------------------------------------------------
         public var text: String = ""
+        /// Array of LabelAttributeModel objects used in rendering the text. 
         public var textAttributes: [any LabelAttributeModel]?
         public var standardStyle: StandardStyle = .titleSmall
         
@@ -39,7 +40,7 @@ extension Tilelet {
         }
               
         //--------------------------------------------------
-        // MARK: - Public Functions
+        // MARK: - Public Methods
         //--------------------------------------------------
         public func toTitleLockupTitleModel() -> TitleLockup.TitleModel {
             TitleLockup.TitleModel(text: text,

VDS/Components/TitleLockup/TitleLockup.swift

@@ -288,7 +288,7 @@ open class TitleLockup: View {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/TitleLockup/TitleLockupEyebrowModel.swift

@@ -11,6 +11,7 @@ extension TitleLockup {
     public struct EyebrowModel {
         public var text: String
         public var isBold: Bool
+        /// Array of LabelAttributeModel objects used in rendering the text. 
         public var textAttributes: [any LabelAttributeModel]?
         public var standardStyle: OtherStandardStyle
         public var numberOfLines: Int

VDS/Components/TitleLockup/TitleLockupSubTitleModel.swift

@@ -12,6 +12,7 @@ extension TitleLockup {
         public var text: String
         public var standardStyle: OtherStandardStyle
         public var textColor: Use
+        /// Array of LabelAttributeModel objects used in rendering the text.
         public var textAttributes: [any LabelAttributeModel]?
         public var numberOfLines: Int
         
@@ -27,6 +28,7 @@ extension TitleLockup {
             self.numberOfLines = numberOfLines
         }
         
+        /// TextStyle used to render the text.
         public var textStyle: TextStyle { standardStyle.value.regular }
 
     }

VDS/Components/TitleLockup/TitleLockupTitleModel.swift

@@ -10,6 +10,7 @@ import Foundation
 extension TitleLockup {
     public struct TitleModel {
         public var text: String
+        /// Array of LabelAttributeModel objects used in rendering the text. 
         public var textAttributes: [any LabelAttributeModel]?
         public var isBold: Bool
         public var standardStyle: TitleStandardStyle
@@ -26,7 +27,8 @@ extension TitleLockup {
             self.standardStyle = standardStyle
             self.numberOfLines = numberOfLines
         }
-        
+
+        /// TextStyle used to render the text.
         public var textStyle: TextStyle { isBold ? standardStyle.value.bold : standardStyle.value.regular }
 
     }

VDS/Components/Toggle/Toggle.swift

@@ -56,6 +56,7 @@ open class Toggle: Control, Changeable {
     private let spacingBetween = VDSLayout.Spacing.space3X.value
     private let labelMaxWidth = 40.0
     
+    /// TextStyle used to render the label.
     private var textStyle: TextStyle {
         if textSize == .small {
             if textWeight == .bold {
@@ -194,7 +195,7 @@ open class Toggle: Control, Changeable {
         setNeedsUpdate()
     }
   
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         
@@ -255,7 +256,7 @@ open class Toggle: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
-    
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize {
         if showLabel {
             label.sizeToFit()

VDS/Components/Toggle/ToggleView.swift

@@ -165,7 +165,7 @@ open class ToggleView: Control, Changeable {
         setNeedsUpdate()
     }
   
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         
@@ -187,6 +187,7 @@ open class ToggleView: Control, Changeable {
     //--------------------------------------------------
     // MARK: - Overrides
     //--------------------------------------------------
+    /// The natural size for the receiving view, considering only properties of the view itself.
     open override var intrinsicContentSize: CGSize { toggleSize }
 
     //--------------------------------------------------

VDS/Components/Tooltip/Tooltip.swift

@@ -143,7 +143,7 @@ open class Tooltip: Control, TooltipLaunchable {
         setNeedsUpdate()
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
 

VDS/Components/Tooltip/TooltipAlertViewController.swift

@@ -105,7 +105,7 @@ open class TooltipAlertViewController: UIViewController, Surfaceable {
         ])
     }
 
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open func updateView() {
         view.backgroundColor = backgroundColorConfiguration.getColor(self).withAlphaComponent(0.3)
         tooltipDialog.surface = surface

VDS/Components/Tooltip/TooltipDialog.swift

@@ -120,7 +120,7 @@ open class TooltipDialog: View, UIScrollViewDelegate {
         heightConstraint?.activate()
     }
 
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
         

VDS/Components/Tooltip/TrailingTooltipLabel.swift

@@ -62,7 +62,7 @@ open class TrailingTooltipLabel: View, TooltipLaunchable {
         }.store(in: &subscribers)
     }
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     open override func updateView() {
         super.updateView()
 

VDS/Extensions/UIColor.swift

@@ -11,7 +11,7 @@ import VDSColorTokens
 
 extension UIColor {
     //--------------------------------------------------
-    // MARK: - Functions
+    // MARK: - Methods
     //--------------------------------------------------
         
     /// Convenience to get a grayscale UIColor where the same value is used for red, green, and blue

VDS/Protocols/ViewProtocol.swift

@@ -19,7 +19,7 @@ public protocol ViewProtocol: AnyObject, Initable, Resettable, Enabling, Surface
     /// Called once when a view is initialized and is used to Setup additional UI or other constants and configurations.
     func setup()
     
-    /// Function used to make changes to the View based off a change events or from local properties.
+    /// Used to make changes to the View based off a change events or from local properties.
     func updateView()
     
     /// Used to update any Accessibility properties.
@@ -27,7 +27,7 @@ public protocol ViewProtocol: AnyObject, Initable, Resettable, Enabling, Surface
 }
 
 extension ViewProtocol {
-    /// Function called when there are changes in a View based off a change events or from local properties.
+    /// Called when there are changes in a View based off a change events or from local properties.
     public func setNeedsUpdate() {
         if shouldUpdateView {
             shouldUpdateView = false
@@ -50,7 +50,7 @@ extension ViewProtocol where Self: UIView {
 }
 
 extension ViewProtocol where Self: UIControl {
-    /// Helper function to assign a completion block to a specific UIControl Event using Combine and stored in the subscribers.
+    /// Helper method to assign a completion block to a specific UIControl Event using Combine and stored in the subscribers.
     public func addEvent(event: UIControl.Event, block: @escaping (Self)->()) {
         publisher(for: event)
             .sink(receiveValue: { c in