Document the process of creating docs with doxygen (#4743)

* Doxygen experimentation

* Substantial improvements to output

* Fix documentation warnings from doxygen

* #4742 Document use of doxygen for doc creation

* Revert to using cref and live with doxygen warnings

* Update Polyfill package version

Author: rockfordlhotka

Source/Csla.Analyzers/Csla.Analyzers/Csla.Analyzers.csproj

@@ -15,7 +15,7 @@
     <PackageReference Include="Microsoft.CodeAnalysis.Analyzers" Version="3.11.0" PrivateAssets="all" />
     <PackageReference Include="Microsoft.CodeAnalysis.CSharp.Workspaces" Version="4.10.0" PrivateAssets="all" />
     <PackageReference Update="NETStandard.Library" PrivateAssets="all" />
-    <PackageReference Include="Polyfill" Version="7.4.0">
+    <PackageReference Include="Polyfill" Version="8.9.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>

Source/Csla.Blazor/State/NoOpSessionManager.cs

@@ -31,12 +31,12 @@ public Session GetCachedSession()
     /// <exception cref="NotSupportedException"></exception>
     public Session GetSession()
     { throw new NotSupportedException(); }
-    /// <summary>
-    /// Not supported
-    /// </summary>
-    /// <returns></returns>
-    /// <exception cref="NotSupportedException"></exception>
-    public void PurgeSessions(TimeSpan expiration)
+  /// <summary>
+  /// Not supported.
+  /// </summary>
+  /// <param name="expiration">Unused expiration value.</param>
+  /// <exception cref="NotSupportedException"></exception>
+  public void PurgeSessions(TimeSpan expiration)
     { throw new NotSupportedException(); }
     /// <summary>
     /// Not supported

Source/Csla.Blazor/State/StateManager.cs

@@ -6,17 +6,29 @@
 // <summary>Get and save state from Blazor pages</summary>
 //-----------------------------------------------------------------------
 
+using System;
+using System.Threading;
+using System.Threading.Tasks;
 using Csla.State;
 
 namespace Csla.Blazor.State
 {
   /// <summary>
   /// Get and save state from Blazor pages.
   /// </summary>
-  /// <param name="sessionManager">The session manager to use for state management.</param>
-  public class StateManager(ISessionManager sessionManager)
+  public class StateManager
   {
-    private readonly ISessionManager _sessionManager = sessionManager;
+    private readonly ISessionManager _sessionManager;
+
+    /// <summary>
+    /// Initializes a new instance of the <see cref="StateManager"/> class.
+    /// </summary>
+    /// <param name="sessionManager">Session manager implementation used to persist page state.</param>
+    /// <exception cref="ArgumentNullException"><paramref name="sessionManager"/> is <see langword="null"/>.</exception>
+    public StateManager(ISessionManager sessionManager)
+    {
+      _sessionManager = sessionManager ?? throw new ArgumentNullException(nameof(sessionManager));
+    }
 
     /// <summary>
     /// Get state from cache.

Source/Csla.Channels.RabbitMq/Csla.Channels.RabbitMq.csproj

@@ -16,7 +16,7 @@
   </ItemGroup>
 
   <ItemGroup Condition="'$(TargetFramework)'=='netstandard2.1'">
-    <PackageReference Include="Polyfill" Version="7.4.0">
+    <PackageReference Include="Polyfill" Version="8.9.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>

Source/Csla.Generators/cs/AutoImplementProperties/Csla.Generator.AutoImplementProperties.CSharp/Csla.Generator.AutoImplementProperties.CSharp.csproj

@@ -46,7 +46,7 @@
     <ProjectReference Include="..\Csla.Generator.AutoImplementProperties.Attributes.CSharp\Csla.Generator.AutoImplementProperties.Attributes.CSharp.csproj" PrivateAssets="All" />
   </ItemGroup>
   <ItemGroup>
-    <PackageReference Include="Polyfill" Version="7.4.0">
+    <PackageReference Include="Polyfill" Version="8.9.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>

Source/Csla.Generators/cs/AutoSerialization/Csla.Generator.AutoSerialization.CSharp/Csla.Generator.AutoSerialization.CSharp.csproj

@@ -42,7 +42,7 @@
   </ItemGroup>
 
   <ItemGroup>
-    <PackageReference Include="Polyfill" Version="7.4.0">
+    <PackageReference Include="Polyfill" Version="8.9.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>

Source/Csla.Web/Design/CslaDesignerDataSourceView.cs

@@ -90,7 +90,7 @@ public override IEnumerable GetDesignTimeData(int minimumRows, out bool isSample
     /// </summary>
     /// <remarks>
     /// All public properties are returned except for those marked
-    /// with the <see cref="BrowsableAttribute">Browsable attribute</see>
+    /// with the <see cref="System.ComponentModel.BrowsableAttribute">Browsable attribute</see>
     /// as False.
     /// </remarks>
     public override IDataSourceViewSchema Schema =>

Source/Csla.Web/Design/ObjectFieldInfo.cs

@@ -66,7 +66,7 @@ public ObjectFieldInfo(PropertyDescriptor field)
     /// </summary>
     /// <remarks>
     /// Returns the optional value provided through
-    /// the <see cref="DataObjectFieldAttribute">DataObjectField</see>
+    /// the <see cref="System.ComponentModel.DataObjectFieldAttribute">DataObjectField</see>
     /// attribute on the property.
     /// </remarks>
     public bool Identity { get; }
@@ -93,7 +93,7 @@ public ObjectFieldInfo(PropertyDescriptor field)
     /// </summary>
     /// <remarks>
     /// Returns the optional value provided through
-    /// the <see cref="DataObjectFieldAttribute">DataObjectField</see>
+    /// the <see cref="System.ComponentModel.DataObjectFieldAttribute">DataObjectField</see>
     /// attribute on the property.
     /// </remarks>
     public int Length { get; }
@@ -111,7 +111,7 @@ public ObjectFieldInfo(PropertyDescriptor field)
     /// Returns True for reference types, and for
     /// value types wrapped in the Nullable generic.
     /// The result can also be set to True through
-    /// the <see cref="DataObjectFieldAttribute">DataObjectField</see>
+    /// the <see cref="System.ComponentModel.DataObjectFieldAttribute">DataObjectField</see>
     /// attribute on the property.
     /// </remarks>
     public bool Nullable { get; }
@@ -128,7 +128,7 @@ public ObjectFieldInfo(PropertyDescriptor field)
     /// </summary>
     /// <remarks>
     /// Returns the optional value provided through
-    /// the <see cref="DataObjectFieldAttribute">DataObjectField</see>
+    /// the <see cref="System.ComponentModel.DataObjectFieldAttribute">DataObjectField</see>
     /// attribute on the property.
     /// </remarks>
     public bool PrimaryKey => IsUnique;

Source/Csla.Web/Design/ObjectViewSchema.cs

@@ -54,8 +54,8 @@ public ObjectViewSchema(CslaDataSourceDesigner? site, string typeName)
     /// </summary>
     /// <remarks>All public properties on the object
     /// will be reflected in this schema list except
-    /// for those properties where the 
-    /// <see cref="BrowsableAttribute">Browsable</see> attribute
+    /// for those properties where the
+    /// <see cref="System.ComponentModel.BrowsableAttribute">Browsable</see> attribute
     /// is False.
     /// </remarks>
     public IDataSourceFieldSchema[] GetFields()

Source/Csla.Windows/Csla.Windows.csproj

@@ -17,7 +17,7 @@
   </PropertyGroup>
 
   <ItemGroup Condition="$(TargetFramework.StartsWith(&quot;net4&quot;))">
-    <PackageReference Include="Polyfill" Version="7.4.0">
+    <PackageReference Include="Polyfill" Version="8.9.0">
       <PrivateAssets>all</PrivateAssets>
       <IncludeAssets>runtime; build; native; contentfiles; analyzers</IncludeAssets>
     </PackageReference>