From b733d1df0e39592548d90ce5d9ba2325ebfa4ca4 Mon Sep 17 00:00:00 2001
From: Ellpeck <me@ellpeck.de>
Date: Wed, 30 Oct 2024 19:47:02 +0100
Subject: [PATCH] small Panel documentation improvements

---
 MLEM.Ui/Elements/Group.cs | 1 +
 MLEM.Ui/Elements/Panel.cs | 4 +++-
 2 files changed, 4 insertions(+), 1 deletion(-)

diff --git a/MLEM.Ui/Elements/Group.cs b/MLEM.Ui/Elements/Group.cs
index ca3a9ad..8035046 100644
--- a/MLEM.Ui/Elements/Group.cs
+++ b/MLEM.Ui/Elements/Group.cs
@@ -6,6 +6,7 @@ namespace MLEM.Ui.Elements {
     /// <summary>
     /// A group element to be used inside of a <see cref="UiSystem"/>.
     /// A group is an element that has no rendering or interaction on its own, but that can aid with automatic placement of child elements.
+    /// If a grouping whose children scroll, and which has a <see cref="ScrollBar"/>, is desired, a panel with its <see cref="Panel.Texture"/> set to <see langword="null"/> can be used.
     /// </summary>
     public class Group : Element {
 
diff --git a/MLEM.Ui/Elements/Panel.cs b/MLEM.Ui/Elements/Panel.cs
index b3f7903..3300fea 100644
--- a/MLEM.Ui/Elements/Panel.cs
+++ b/MLEM.Ui/Elements/Panel.cs
@@ -13,6 +13,7 @@ namespace MLEM.Ui.Elements {
     /// A panel element to be used inside of a <see cref="UiSystem"/>.
     /// The panel is a complex element that displays a box as a background to all of its child elements.
     /// Additionally, a panel can be set to scroll overflowing elements on construction, which causes all elements that don't fit into the panel to be hidden until scrolled to using a <see cref="ScrollBar"/>.
+    /// If an element similar to a <see cref="Group"/>, but with scrolling content, is desired, a panel with its <see cref="Texture"/> set to <see langword="null"/> can be used.
     /// </summary>
     public class Panel : Element {
 
@@ -24,7 +25,8 @@ namespace MLEM.Ui.Elements {
         public readonly ScrollBar ScrollBar;
 
         /// <summary>
-        /// The texture that this panel should have, or null if it should be invisible.
+        /// The texture that this panel should have.
+        /// If this is set to <see langword="null"/>, this panel will not have a texture, but all of its content will still be visible.
         /// </summary>
         public StyleProp<NinePatch> Texture;
         /// <summary>