diff --git a/OpenRA.Mods.D2k/Traits/World/ChooseBuildTabOnSelect.cs b/OpenRA.Mods.D2k/Traits/World/ChooseBuildTabOnSelect.cs
index 8537910eb7..aa550836ae 100644
--- a/OpenRA.Mods.D2k/Traits/World/ChooseBuildTabOnSelect.cs
+++ b/OpenRA.Mods.D2k/Traits/World/ChooseBuildTabOnSelect.cs
@@ -16,6 +16,8 @@ using OpenRA.Widgets;
 
 namespace OpenRA.Mods.D2k.Traits
 {
+	[Desc("If the BuildPaletteWidget is used, this trait needs to be added to world actor",
+	"to make the build palette open automatically when a production facility is deployed.")]
 	class ChooseBuildTabOnSelectInfo : ITraitInfo
 	{
 		public readonly string BuildPaletteWidgetName = "INGAME_BUILD_PALETTE";
diff --git a/OpenRA.Mods.D2k/Widgets/BuildPaletteWidget.cs b/OpenRA.Mods.D2k/Widgets/BuildPaletteWidget.cs
index 6a50490f5c..2474d8a054 100644
--- a/OpenRA.Mods.D2k/Widgets/BuildPaletteWidget.cs
+++ b/OpenRA.Mods.D2k/Widgets/BuildPaletteWidget.cs
@@ -26,6 +26,8 @@ using OpenRA.Widgets;
 
 namespace OpenRA.Mods.D2k.Widgets
 {
+	[Desc("Classic BuildPaletteWidget. Needs ChooseBuildTabOnSelect trait to be added to world actor",
+	"in order to make the build palette open automatically when a production facility is deployed.")]
 	class BuildPaletteWidget : Widget
 	{
 		public enum ReadyTextStyleOptions { Solid, AlternatingColor, Blinking }