feat: Adds more documentation and examples.

Sources/CliDocCore/Nodes/VStack.swift

@@ -1,10 +1,30 @@
 /// A vertical stack of text nodes.
 ///
+/// ### Example:
+///
+/// ```swift
+/// let vStack = VStack {
+///   "Blob Esquire"
+///     .color(.yellow)
+///     .bold()
+///     .underline()
+///
+///   "Blob is a super awesome worker.".italic()
+/// }
+///
+/// print(vStack.render())
+/// ```
+/// ![VStack rendered output](vstack.png)
+///
 ///
 public struct VStack: TextNode {
   @usableFromInline
   let content: [any TextNode]
 
+  /// Create a new ``VStack`` with the given text nodes.
+  ///
+  /// - Parameters:
+  ///   - content: The content of the vstack.
   @inlinable
   public init(
     @TextBuilder content: () -> any TextNode
@@ -20,10 +40,18 @@ public struct VStack: TextNode {
 
 public extension VStack {
 
+  /// Apply the given style to a ``VStack``.
+  ///
+  /// - Parameters:
+  ///   - style: The style to apply to the ``VStack``.
   func style<S: VStackStyle>(_ style: S) -> some TextNode {
     style.render(content: .init(content: content.removingEmptys()))
   }
 
+  /// Apply the given separator to a ``VStack``.
+  ///
+  /// - Parameters:
+  ///   - separator: The vertical separator to use with the ``VStack``.
   func separator(_ separator: Separator.Vertical) -> some TextNode {
     style(.separator(separator))
   }
@@ -31,16 +59,29 @@ public extension VStack {
 
 // MARK: - Style
 
+/// Style a ``VStack`` by creating a type that conforms to ``VStackStyle`` and use the
+/// style by calling the ``VStack/style(_:)`` method on your instance.
+///
 public protocol VStackStyle: TextModifier where Content == StackConfiguration {}
 
 public extension VStackStyle where Self == VStackSeparatorStyle {
 
+  /// Apply the given separator on a ``VStack``.
+  ///
+  /// - See Also: ``VStack/separator(_:)``
+  ///
+  /// - Parameters:
+  ///   - separator: The vertical separator to use with the ``VStack``.
   static func separator(_ separator: Separator.Vertical) -> Self {
     VStackSeparatorStyle(separator: separator)
   }
 
 }
 
+/// Separate items in a ``VStack`` with a given vertical separator.
+///
+/// - See Also: ``VStack/separator(_:)``.
+///
 public struct VStackSeparatorStyle: VStackStyle {
   @usableFromInline
   let separator: Separator.Vertical