docs: XML comments for Devices.Common

src/PepperDash.Essentials.Devices.Common/Shades/RelayControlledShade.cs

@@ -27,6 +27,12 @@ namespace PepperDash.Essentials.Devices.Common.Shades
         /// </summary>
         public string StopOrPresetButtonLabel { get; set; }
 
+        /// <summary>
+        /// Initializes a new instance of the RelayControlledShade class
+        /// </summary>
+        /// <param name="key">The device key</param>
+        /// <param name="name">The device name</param>
+        /// <param name="config">The relay controlled shade configuration</param>
         public RelayControlledShade(string key, string name, RelayControlledShadeConfigProperties config)
             : base(key, name)
         {
@@ -157,6 +163,9 @@ namespace PepperDash.Essentials.Devices.Common.Shades
     /// </summary>
     public class RelayControlledShadeFactory : EssentialsDeviceFactory<RelayControlledShade>
     {
+        /// <summary>
+        /// Initializes a new instance of the RelayControlledShadeFactory class
+        /// </summary>
         public RelayControlledShadeFactory()
         {
             TypeNames = new List<string>() { "relaycontrolledshade" };

src/PepperDash.Essentials.Devices.Common/Shades/ShadeBase.cs

@@ -1,10 +1,18 @@
-using PepperDash.Essentials.Core.Shades;
-using PepperDash.Essentials.Core;
+using PepperDash.Essentials.Core;
+using PepperDash.Essentials.Core.Shades;
 
 namespace PepperDash.Essentials.Devices.Common.Shades
 {
+    /// <summary>
+    /// Base class for shade devices
+    /// </summary>
     public abstract class ShadeBase : EssentialsDevice, IShadesOpenCloseStop
     {
+        /// <summary>
+        /// Initializes a new instance of the ShadeBase class
+        /// </summary>
+        /// <param name="key">The device key</param>
+        /// <param name="name">The device name</param>
         public ShadeBase(string key, string name)
             : base(key, name)
         {
@@ -13,8 +21,17 @@ namespace PepperDash.Essentials.Devices.Common.Shades
 
         #region iShadesOpenClose Members
 
+        /// <summary>
+        /// Opens the shade
+        /// </summary>
         public abstract void Open();
+        /// <summary>
+        /// Stops the shade
+        /// </summary>
         public abstract void Stop();
+        /// <summary>
+        /// Closes the shade
+        /// </summary>
         public abstract void Close();
 
         #endregion

src/PepperDash.Essentials.Devices.Common/Shades/ShadeController.cs

@@ -14,8 +14,17 @@ namespace PepperDash.Essentials.Devices.Common.Shades
     {
         ShadeControllerConfigProperties Config;
 
+        /// <summary>
+        /// Gets the collection of shades controlled by this controller
+        /// </summary>
         public List<IShadesOpenCloseStop> Shades { get; private set; }
 
+        /// <summary>
+        /// Initializes a new instance of the ShadeController class
+        /// </summary>
+        /// <param name="key">The device key</param>
+        /// <param name="name">The device name</param>
+        /// <param name="config">The shade controller configuration</param>
         public ShadeController(string key, string name, ShadeControllerConfigProperties config)
             : base(key, name)
         {
@@ -76,6 +85,9 @@ namespace PepperDash.Essentials.Devices.Common.Shades
     /// </summary>
     public class ShadeControllerFactory : EssentialsDeviceFactory<ShadeController>
     {
+        /// <summary>
+        /// Initializes a new instance of the ShadeControllerFactory class
+        /// </summary>
         public ShadeControllerFactory()
         {
             TypeNames = new List<string>() { "shadecontroller" };