diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckList.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckList.cs
index 3caba2572..ed04df0e6 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckList.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckList.cs
@@ -1,3 +1,8 @@
 namespace Elsa.Api.Client.Shared.UIHints.CheckList;
 
+/// <summary>
+/// Represents a list of check list items.
+/// </summary>
+/// <param name="Items">The items.</param>
+/// <param name="IsFlagsEnum">Whether the select list represents a flags enum.</param>
 public record CheckList(IEnumerable<CheckListItem> Items, bool IsFlagsEnum = false);
\ No newline at end of file
diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListItem.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListItem.cs
index 53cd50bd6..62d5e6bf5 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListItem.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListItem.cs
@@ -1,10 +1,6 @@
 namespace Elsa.Api.Client.Shared.UIHints.CheckList;
 
-public class CheckListItem
-{
-#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
-    public string Text { get; set; }
-    public string Value { get; set; }
-#pragma warning restore CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
-    public bool IsChecked { get; set; }
-}
\ No newline at end of file
+/// <summary>
+/// Represents an item in a <see cref="CheckList"/>.
+/// </summary>
+public record CheckListItem(string Text, string Value, bool IsChecked);
\ No newline at end of file
diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListProps.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListProps.cs
index 431e9263d..4ef203dc7 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListProps.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/CheckList/CheckListProps.cs
@@ -1,5 +1,8 @@
 namespace Elsa.Api.Client.Shared.UIHints.CheckList;
 
+/// <summary>
+/// Provides properties for the <c>checklist</c> UI hint.
+/// </summary>
 public class CheckListProps
 {
     /// <summary>
diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioList.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioList.cs
index 3075e7be8..b17e00f1e 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioList.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioList.cs
@@ -1,3 +1,8 @@
 namespace Elsa.Api.Client.Shared.UIHints.RadioList;
 
+/// <summary>
+/// Represents a list of radio list items.
+/// </summary>
+/// <param name="Items">The items.</param>
+/// <param name="IsFlagsEnum">Whether the select list represents a flags enum.</param>
 public record RadioList(IEnumerable<RadioListItem> Items, bool IsFlagsEnum = false);
\ No newline at end of file
diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListItem.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListItem.cs
index 45ba5d2e2..3e7722287 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListItem.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListItem.cs
@@ -1,9 +1,6 @@
 namespace Elsa.Api.Client.Shared.UIHints.RadioList;
 
-public class RadioListItem
-{
-#pragma warning disable CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
-    public string Text { get; set; }
-    public string Value { get; set; }
-#pragma warning restore CS8618 // Non-nullable field must contain a non-null value when exiting constructor. Consider declaring as nullable.
-}
\ No newline at end of file
+/// <summary>
+/// Represents an item in a <see cref="RadioList"/>.
+/// </summary>
+public record RadioListItem(string Text, string Value);
\ No newline at end of file
diff --git a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListProps.cs b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListProps.cs
index a4441a15f..be100b644 100644
--- a/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListProps.cs
+++ b/src/clients/Elsa.Api.Client/Shared/UIHints/RadioList/RadioListProps.cs
@@ -1,5 +1,8 @@
 namespace Elsa.Api.Client.Shared.UIHints.RadioList;
 
+/// <summary>
+/// Provides properties for the <c>radiolist</c> UI hint.
+/// </summary>
 public class RadioListProps
 {
     /// <summary>
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckList.cs b/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckList.cs
index dcb697d7e..4380ecae1 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckList.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckList.cs
@@ -1,7 +1,17 @@
 namespace Elsa.Workflows.UIHints.CheckList;
 
+/// <summary>
+/// Provides properties for the <see cref="InputUIHints.CheckList"/> UI hint.
+/// </summary>
 public class CheckList
 {
+    /// <summary>
+    /// The radio list.
+    /// </summary>
     public IEnumerable<CheckListItem> Items { get; set; }
+
+    /// <summary>
+    /// The name of the provider that will provide the select list.
+    /// </summary>
     public bool IsFlagsEnum { get; set; }
 }
\ No newline at end of file
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckListProps.cs b/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckListProps.cs
index 4d3d6e8df..f2dda59aa 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckListProps.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/CheckList/CheckListProps.cs
@@ -1,5 +1,8 @@
 namespace Elsa.Workflows.UIHints.CheckList;
 
+/// <summary>
+/// Provides properties for the <see cref="InputUIHints.CheckList"/> UI hint.
+/// </summary>
 public class CheckListProps
 {
     /// <summary>
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/Dropdown/DropDownOptionsProviderBase.cs b/src/modules/Elsa.Workflows.Core/UIHints/Dropdown/DropDownOptionsProviderBase.cs
index e248cb557..5ee12af51 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/Dropdown/DropDownOptionsProviderBase.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/Dropdown/DropDownOptionsProviderBase.cs
@@ -4,7 +4,8 @@ using Elsa.Extensions;
 namespace Elsa.Workflows.UIHints.Dropdown;
 
 /// <summary>
-/// 
+/// A base class for providing options to populate a dropdown UI component. This class is intended to be inherited to implement
+/// custom dropdown data logic by overriding the `GetItemsAsync` method.
 /// </summary>
 public abstract class DropDownOptionsProviderBase : IPropertyUIHandler
 {
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioList.cs b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioList.cs
index 0dd5e25ec..ace833be9 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioList.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioList.cs
@@ -1,7 +1,17 @@
 namespace Elsa.Workflows.UIHints.RadioList;
 
+/// <summary>
+/// Provides properties for the <see cref="InputUIHints.RadioList"/> UI hint.
+/// </summary>
 public class RadioList
 {
+    /// <summary>
+     /// The radio list.
+     /// </summary>
     public IEnumerable<RadioListItem> Items { get; set; }
+
+    /// <summary>
+    /// The name of the provider that will provide the select list.
+    /// </summary>
     public bool IsFlagsEnum { get; set; }
 }
\ No newline at end of file
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListOptionsProviderBase.cs b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListOptionsProviderBase.cs
index aa09266cb..70bae9a45 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListOptionsProviderBase.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListOptionsProviderBase.cs
@@ -34,7 +34,7 @@ public abstract class RadioListOptionsProviderBase : PropertyUIHandlerBase
     }
 
     /// <summary>
-    /// Implement this to provide items to the dropdown list.
+    /// Implement this to provide items to the radio list.
     /// </summary>
     protected abstract ValueTask<ICollection<RadioListItem>> GetItemsAsync(PropertyInfo propertyInfo, object? context, CancellationToken cancellationToken);
 
diff --git a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListProps.cs b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListProps.cs
index 2465cdda5..bdb15084a 100644
--- a/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListProps.cs
+++ b/src/modules/Elsa.Workflows.Core/UIHints/RadioList/RadioListProps.cs
@@ -1,5 +1,8 @@
 namespace Elsa.Workflows.UIHints.RadioList;
 
+/// <summary>
+/// Provides properties for the <see cref="InputUIHints.RadioList"/> UI hint.
+/// </summary>
 public class RadioListProps
 {
     /// <summary>