fix: correct malformed XML comments and cref references

Author: ReneSchwarzer

.github/workflows/generate-preview-docs.yml

@@ -81,7 +81,7 @@ jobs:
     - name: Upload artifact
       uses: actions/upload-pages-artifact@v3
       with:
-        path: '_site'
+        path: './docs/_site'
 
     - name: Deploy to GitHub Pages
       id: deployment

docs/docfx.json

@@ -48,9 +48,6 @@
         "TODO": "alert alert-secondary"
       }
     },
-    "xref": [
-      "../.xrefmap.json"
-    ],
     "output": "_site",
     "template": [
       "default",

src/WebExpress.WebUI/WebControl/ControlResponsive.cs

@@ -39,7 +39,7 @@ public ControlResponsive(string id = null)
         /// </summary>
         /// <param name="panel">The panel to add.</param>
         /// <param name="breakpoint">
-        /// The minimum width at which the panel becomes visible. Use < 0 to register as fallback panel.
+        /// The minimum width at which the panel becomes visible. Use values less than 0 to register as fallback panel.
         /// </param>
         /// <returns>The current instance for method chaining.</returns>
         public IControlResponsive Add(IControlPanel panel, int breakpoint)

src/WebExpress.WebUI/WebControl/ControlSearch.cs

@@ -40,7 +40,7 @@ public class ControlSearch : Control
         /// </summary>
         public IControl Footer { get; set; }
 
-        // <summary>
+        /// <summary>
         /// Returns or sets a value indicating whether favorited suggestions are enabled.
         /// </summary>
         public bool EnableFavorited { get; set; }

src/WebExpress.WebUI/WebControl/ControlToolbar.cs

@@ -108,7 +108,7 @@ public IControlToolbar Add(params IControlToolbarItem[] items)
         /// var tool = new ControlToolbar();
         /// var item1 = new ControlToolBarItemButton { Text = "Item 1" };
         /// var item2 = new ControlToolBarItemButton { Text = "Item 2" };
-        /// tool.Add(new List<IControlToolbarItem>([ item1, item2 ]));
+        /// tool.Add(item1, item2);
         /// </code>
         /// 
         /// This method accepts any item that derives from <see cref="IControlToolbarItem"/>.

src/WebExpress.WebUI/WebControl/IControl.cs

@@ -78,6 +78,7 @@ public interface IControl : IWebUIElement<IRenderControlContext, IVisualTreeCont
         /// </summary>
         IEnumerable<string> Classes { get; set; }
 
+        /// <summary>
         /// Returns or sets the css style.
         /// </summary>
         IEnumerable<string> Styles { get; set; }

src/WebExpress.WebUI/WebControl/IControlNavigation.cs

@@ -41,7 +41,7 @@ public interface IControlNavigation : IControl
         /// var control = new ControlNavigation(); 
         /// var text1 = new ControlNavigationItemLink { Text = "A" };
         /// var text2 = new ControlNavigationItemLink { Text = "B" };
-        /// control.Add(new List<IControlNavigationItem> { text1, text2 });
+        /// control.Add(text1, text2);
         /// </code> 
         /// 
         /// This method accepts any items that implement the <see cref="IControlNavigationItem"/> interface.

src/WebExpress.WebUI/WebControl/IControlResponsive.cs

@@ -6,11 +6,11 @@
     public interface IControlResponsive : IControl
     {
         /// <summary>
-        /// Adds a panel that becomes visible at the specified breakpoint.
+        /// Adds a panel with a specific breakpoint.
         /// </summary>
         /// <param name="panel">The panel to add.</param>
         /// <param name="breakpoint">
-        /// The minimum width at which the panel becomes visible. Use < 0 to register as fallback panel.
+        /// The minimum width at which the panel becomes visible. Use values less than 0 to register as fallback panel.
         /// </param>
         /// <returns>The current instance for method chaining.</returns>
         IControlResponsive Add(IControlPanel panel, int breakpoint);

src/WebExpress.WebUI/WebControl/IControlToolbar.cs

@@ -56,7 +56,7 @@ public interface IControlToolbar : IControl
         /// var tool = new ControlToolbar();
         /// var item1 = new ControlToolBarItemButton { Text = "Item 1" };
         /// var item2 = new ControlToolBarItemButton { Text = "Item 2" };
-        /// tool.Add(new List<IControlToolbarItem> { item1, item2 });
+        /// tool.Add(item1, item2);
         /// </code>
         /// 
         /// This method accepts any item that derives from <see cref="IControlToolbarItem"/>.

src/WebExpress.WebUI/WebControl/IControlUpload.cs

@@ -18,7 +18,7 @@ public interface IControlUpload : IControl
         /// </summary>
         IUri Uri { get; }
 
-        // <summary>
+        /// <summary>
         /// Returns a value indicating whether multiple selections are allowed.
         /// </summary>
         bool Multiple { get; }