feat: 🎸 [JIRA:HCPSDKFIORIUIKIT-2686] document public declarations

Author: hengyi-zhang

Diff for: Sources/FioriSwiftUICore/FioriButton/FioriButton.swift

@@ -217,11 +217,15 @@ public enum FioriButtonLoadingState {
     case success
 }
 
-/// image position related to the title
+/// Place the image along the top, leading, bottom, or trailing edge of the button.
 public enum FioriButtonImagePosition {
+    /// place the image along the top edge of the button.
     case top
+    /// place the image along the leading edge of the button.
     case leading
+    /// place the image along the bottom edge of the button.
     case bottom
+    /// place the image along the trailing edge of the button.
     case trailing
 }
 
@@ -232,10 +236,10 @@ public extension FioriButton {
     ///   - isSelectionPersistent: A boolean value determines whether the button should be persistent or not.
     ///   - action: Action triggered when tap on button.
     ///   - title: A closure that returns a title text for each state. For a button with non-persistent selection, `.normal`, `.disabled`, `.highlighted` are supported. For a button with persistent selection, use `.selected` instead of `.highlighted`.
-    ///   - image: image of the button when loading state is .unspecified
-    ///   - loadingState: A state to show activity indicator or success icon, default is .unspecified
-    ///   - imagePosition: image position related to the title
-    ///   - imageTitleSpacing: spacing between image and title
+    ///   - image: image of the button when loading state is .unspecified.
+    ///   - loadingState: A state to show activity indicator or success icon, default is .unspecified.
+    ///   - imagePosition: Place the image along the top, leading, bottom, or trailing edge of the button.
+    ///   - imageTitleSpacing: spacing between image and title.
     init(isSelectionPersistent: Bool = false,
          action: ((UIControl.State) -> Void)? = nil,
          title: ((UIControl.State) -> AttributedString)? = nil,